Passer au contenu principal
POST
Créer un contact seul

Autorisations

Authorization
string
header
requis

Token LinkedAPI avec scope externalIntegration. La clé doit avoir un agencyGroup configuré (sinon 400 LinkedAPI agencyGroup is required). Fourni via l'en-tête Authorization: Bearer {linkedAPI_token}. Si la clé a secure === true, l'IP appelante doit être whitelistée (en-tête X-Real-IP), sinon 403 Not authorized to access this resource.

La clé porte aussi un niveau d'accès : en lecture seule, elle n'autorise que les GET ; un POST ou un PATCH renvoie alors 403 Not authorized to access this resource, soit la même réponse qu'une requête sans en-tête Authorization. Voir le guide Authentification.

Corps

application/json

Au moins un de email / phone est requis. Particulier : firstName ou lastName. Entreprise (isIndividual: false) : commercialName ou corporateName.

agencyId
string
requis

Agence cible. Doit appartenir au périmètre autorisé de la clé.

Pattern: ^[a-fA-F0-9]{24}$
Exemple:

"618a35a36d932054e195ca0a"

firstName
string
lastName
string
email
string<email>
phone
string

Téléphone au format international.

isEmailVerified
boolean
isPhoneVerified
boolean
isIndividual
boolean
défaut:true

true (défaut) = particulier ; false = entreprise.

commercialName
string
corporateName
string

Consentement à la prospection que vous avez recueilli. Déclarez le parcours dont la personne a vu la mention (journey), ou énoncez chaque canal. Sans journey, un canal absent est enregistré comme non consenti sur un nouveau contact, et laissé tel quel sur un contact déjà connu (dédup) : seul un false explicite retire alors un consentement. Voir le guide Consentement à la prospection.

Réponse

Contact créé (ou réutilisé si déjà existant, isNew: false).

success
boolean
contact
object

Contact. firstName / lastName si isIndividual: true ; commercialName / corporateName si entreprise (isIndividual: false).

isNew
boolean

false si un contact existant a été réutilisé (déduplication).