Crée ou met à jour un contact
Crée un contact marketing identifié par email, phone_number et/ou une souscription web push — sans customer_id, donc adapté aux personnes qui ne sont pas clientes de la boutique. S'appuie sur le même moteur que l'import de contacts de l'interface : si un contact correspond déjà à l'un des identifiants, seuls les champs fournis sont mis à jour (les champs omis ne sont jamais réinitialisés), et si le contact trouvé est un client enregistré son identité synchronisée n'est pas modifiée (seuls consentement, suivi et push sont appliqués). La déduplication suit la priorité de l'import — email d'abord, puis phone_number, puis push ; meta.matched_by indique l'identifiant retenu. Les valeurs de consentement portent un acte explicite du contact, comme un fichier d'import : un opt-in peut lever un désabonnement et unsubscribed en pose un — n'envoyez un champ de consentement que lorsque le contact a réellement exprimé ce choix. L'historique d'audit enregistre la source API.
Parameters
Header Parameters
[Authentication] Required API key, in the form {prefix}.{secret}.
"a1b2c3d4.xK9pR2mVn6QwErTyUiOpAsDfGhJkLzXcVbNmQwErTyU""^[a-zA-Z0-9]{8}\\.[A-Za-z0-9_-]+$"Request Body
Responses
A contact already matched one of the identifiers: it has been updated (operation: updated) or left as is (operation: unchanged).
Crée ou met à jour un contact Crée un contact marketing identifié par email, phone_number et/ou une souscription web push — sans customer_id, donc adapté aux personnes qui ne sont pas clientes de la boutique. S'appuie sur le même moteur que l'import de contacts de l'interface : si un contact correspond déjà à l'un des identifiants, seuls les champs fournis sont mis à jour (les champs omis ne sont jamais réinitialisés), et si le contact trouvé est un client enregistré son identité synchronisée n'est pas modifiée (seuls consentement, suivi et push sont appliqués). La déduplication suit la priorité de l'import — email d'abord, puis phone_number, puis push ; meta.matched_by indique l'identifiant retenu. Les valeurs de consentement portent un acte explicite du contact, comme un fichier d'import : un opt-in peut lever un désabonnement et unsubscribed en pose un — n'envoyez un champ de consentement que lorsque le contact a réellement exprimé ce choix. L'historique d'audit enregistre la source API. POST /v1/contacts createContact Contacts spm-api-key [Authentication] Required API key, in the form {prefix}.{secret}. A contact already matched one of the identifiers: it has been updated (operation: updated) or left as is (operation: unchanged). Contact successfully created. Client error - Invalid request or authentication issues Server error - Internal processing failure