Aller au contenu
Documentation

Avec un nouveau contact

Faire signer votre document à une personne qui n'est pas encore un contact — le contact est créé avec le parcours.

1 min de lecture Mise à jour le 9 novembre 2026
cURL
curl -X POST "https://staging-api.docage.com/Transactions/CreateFullTransaction" \
  -H "Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9…" \
  -F 'Transaction={"Name":"Contrat avec Atelier Lumière","TransactionFiles":[{"FriendlyName":"Contrat","Name":"Contrat de prestation"}],"TransactionMembers":[{"FriendlyName":"Client","MemberRole":0,"SignMode":1}]}' \
  -F 'Client={"FirstName":"Camille","LastName":"Martin","Email":"camille.martin@example.com","Mobile":"+33600000001","Address1":"12 rue des Lilas","ZipCode":"69003","City":"Lyon","Country":"FR"}' \
  -F "Contrat=@contrat-atelier-lumiere.pdf;type=application/pdf" \
  -F 'Client,Contrat={"Pages":"-1","Coordinates":"320,90,180,100"}'

Sous l'identifiant convivial du participant, un contact en JSON : ses propriétés sont celles d'un contact (FirstName, LastName, Email, Mobile, Phone, Address1, Address2, ZipCode, City, Country, Job…). Le contact est enregistré avec le parcours — une création qui échoue n'en laisse aucun —, et le participant prend ses coordonnées.

Ce qui est vérifié, et quand

Rien n'est vérifié à la création du contact. L'envoi exige de chaque participant un email valide, un prénom et un nom, et un mobile pour un code par SMS ; un manque fait refuser l'envoi (« Client : n'a pas un prénom valide »…) et laisse le parcours en brouillon, avec le contact créé.

Les pièges

  • Aucun contrôle de doublon n'empêche cette création : cherchez d'abord la personne par son email, et désignez son contact s'il existe.
  • Un JSON qui porte un Id ne crée rien : il met à jour ce contact — voir En modifiant un contact existant.
  • Country est un code de pays ISO à deux lettres (FR) ; un libellé (« FRANCE ») est gardé tel quel, sans être reconnu.
  • Écrivez un numéro au format international E.164 (+33600000001).