Crear un contacte
Desa una adreça a la llibreta d'adreces de l'espai de treball. L'adreça és la identitat, de manera que no hi ha cap id per triar ni cap a la resposta. Es retalla i es passa a minúscules abans de desar-se, i el contacte es desa amb `source` a `manual`. El contacte nou entra a l'audiència per defecte integrada mentre s'escriu, a més del que s'anomeni a `audienceIds`.
Executa la crida real contra el teu espai de treball, amb la teva pròpia clau.
POST /contacts
Desa una adreça a la llibreta d'adreces de l'espai de treball. L'adreça és la identitat, de manera que no hi ha cap id per triar ni cap a la resposta. Es retalla i es passa a minúscules abans de desar-se, i el contacte es desa amb source a manual. El contacte nou entra a l'audiència per defecte integrada mentre s'escriu, a més del que s'anomeni a audienceIds.
Exemple
Requereix contacts:write. Enviar audienceIds requereix també 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" } ]}Una adreça que ja és a la llibreta és un 409 contact_exists i no una fusió, de manera que un reintent no pot sobreescriure en silenci un nom que algú ha editat a l'aplicació. Llegeix la fila i fes-hi un PATCH.
lastSeenAt es queda a null fins que surt correu cap a l'adreça des del redactor de l'aplicació. source i lastSeenAt són del servidor i no s'accepten al cos.
Un id d'audiència a audienceIds que no existeix en aquest espai de treball és un 404 i no s'escriu res.