API et webhooks Clinch

Trois recettes

• Envoyer un contrat depuis votre propre app

  POST /api/v1/documents avec un modèle ou votre texte et les signataires : le contrat est créé et envoyé en signature en un seul appel, avec un acompte en option.

• Facturer quand le travail est validé

  Écoutez contract.signed et appelez POST /api/v1/invoices pour facturer la première étape avec un lien de paiement.

• Synchroniser clients et documents avec votre CRM

  GET /api/v1/clients et /api/v1/documents renvoient le statut, les signataires et les liens de signature pour garder vos données à jour.

Configuration

1. Créez une clé dans Clinch sous Paramètres → Clés API et envoyez-la sous la forme Authorization: Bearer <clé>.
2. Créez un contrat avec POST /api/v1/documents (title, template ou text, signers, deposit_cents en option).
3. Abonnez-vous aux événements avec POST /api/v1/webhooks ou dans Paramètres → Intégrations (Pro).
4. Vérifiez l'en-tête X-Clinch-Signature de chaque envoi avec votre secret de signature.

Exemple

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"}]}'

Questions