Contacts

Contact professionnel rattaché à une company, utilisé pour la collecte, la signature et les rôles.

Objet métier

Vue d’ensemble

Les endpoints contacts permettent de maintenir le nom d’affichage et les coordonnées d’un contact. Le rattachement à une company est obligatoire ; les contrôles sont des compliance_check séparés.

Voir aussi la page du modèle métier contact pour la sémantique, les relations et le cycle de vie fonctionnel.

Contrat JSON

Objet `contact`

Les réponses utilisent l’identifiant préfixé ctc_ et le champ object pour rendre le type explicite.

company_idstring

Identifiant de la company à laquelle le contact appartient.

merchant_idstring

Identifiant du marchand.

full_namestring

Nom complet canonique et obligatoire.

first_name / last_namestring

Composantes structurées facultatives.

email / phonestring

Coordonnées de contact.

job_title / preferred_localestring

Fonction et locale BCP 47 préférée.

REST

Endpoints

Méthode	Endpoint	Usage
POST	`/v1/contacts`	Créer un contact.
GET	`/v1/contacts`	Lister les contacts, avec filtres company_id, merchant_id ou source_reference.
GET	`/v1/contacts/search`	Résoudre un contact unique par email, éventuellement dans une company.
GET	`/v1/contacts/{id}`	Récupérer un contact.
POST	`/v1/contacts/{id}`	Mettre à jour le profil professionnel et les coordonnées.
POST	`/v1/contacts/{id}/suspend`	Suspendre le contact sans effacer son historique.
POST	`/v1/contacts/{id}/reactivate`	Lever la suspension du contact.

Événements

Événements associés

Ces événements peuvent être consommés via les webhooks plateforme lorsque le compte est configuré pour les recevoir.

contact.createdcontact.updatedcontact.suspendedcontact.reactivated

Comportement

Points d’attention

La recherche retourne contact_search_result avec contact ou null.
source_reference en listing impose merchant_id pour éviter une recherche globale ambiguë.
Un contact suspendu reste consultable et modifiable, mais n'est plus résolu et ne peut plus recevoir de rôle.