Clinch-API und Webhooks

Drei Rezepte

• Einen Vertrag aus deiner eigenen App senden

  POST /api/v1/documents mit einer Vorlage oder deinem Text und den Unterzeichnern: Der Vertrag wird in einem Aufruf erstellt und zur Unterschrift gesendet, optional mit Anzahlung.

• Abrechnen, sobald die Arbeit freigegeben ist

  Hör auf contract.signed und ruf POST /api/v1/invoices auf, um den ersten Meilenstein mit Zahlungslink abzurechnen.

• Kunden und Dokumente mit deinem CRM synchronisieren

  GET /api/v1/clients und /api/v1/documents liefern Status, Unterzeichner und Signaturlinks, damit deine Daten aktuell bleiben.

Einrichtung

1. Erstelle in Clinch unter Einstellungen → API-Schlüssel einen Schlüssel und sende ihn als Authorization: Bearer <Schlüssel>.
2. Erstelle einen Vertrag mit POST /api/v1/documents (title, template oder text, signers, optional deposit_cents).
3. Abonniere Ereignisse mit POST /api/v1/webhooks oder unter Einstellungen → Integrationen (Pro).
4. Prüfe den X-Clinch-Signature-Header jeder Zustellung mit deinem Signatur-Secret.

Beispiel

curl https://clinch.lumnika.com/api/v1/documents \
  -H "Authorization: Bearer clk_your_key" \
  -H "Content-Type: application/json" \
  -d '{"title":"Logo design","template":"logo-design-contract",
       "signers":[{"name":"Jane Doe","email":"jane@acme.com"}]}'

Fragen