Créer un contact
Enregistre une adresse dans le carnet d'adresses de l'espace de travail. L'adresse est l'identité : il n'y a donc pas d'id à choisir, ni d'id dans la réponse. Elle est débarrassée de ses espaces et passée en minuscules avant d'être stockée, et le contact est enregistré avec `source` à `manual`. Le nouveau contact rejoint l'audience par défaut intégrée au moment où il est écrit, ainsi que toutes celles nommées dans `audienceIds`.
Exécute le véritable appel sur votre espace de travail, avec votre propre clé.
POST /contacts
Enregistre une adresse dans le carnet d'adresses de l'espace de travail. L'adresse est l'identité : il n'y a donc pas d'id à choisir, ni d'id dans la réponse. Elle est débarrassée de ses espaces et passée en minuscules avant d'être stockée, et le contact est enregistré avec source à manual. Le nouveau contact rejoint l'audience par défaut intégrée au moment où il est écrit, ainsi que toutes celles nommées dans audienceIds.
Exemple
Nécessite contacts:write. Envoyer audienceIds nécessite en plus audiences:write.
curl -X POST "$OE/contacts" -H "$AUTH" -H 'content-type: application/json' -d '{ "email": "[email protected]", "name": "Grace Hopper", "notes": "Met at the compiler workshop"}'{ "object": "contact", "email": "[email protected]", "name": "Grace Hopper", "source": "manual", "notes": "Met at the compiler workshop", "lastSeenAt": null, "createdAt": "2026-09-18T09:00:00.000Z", "updatedAt": "2026-09-18T09:00:00.000Z", "audiences": [ { "id": "aud_9f2c4b7e1a0d63d84c5f2e7b", "name": "All contacts", "builtin": "default" } ]}Une adresse déjà présente dans le carnet donne un 409 contact_exists plutôt qu'une fusion : une nouvelle tentative ne peut donc pas écraser discrètement un nom que quelqu'un a modifié dans l'application. Lisez plutôt la ligne et faites un PATCH dessus.
lastSeenAt reste null tant qu'aucun message n'est parti vers l'adresse depuis la fenêtre de rédaction de l'application. source et lastSeenAt appartiennent au serveur et ne sont pas acceptés dans le corps.
Un id d'audience figurant dans audienceIds mais qui n'existe pas dans cet espace de travail donne un 404, et rien n'est écrit.