Crear un contacto
Guarda una dirección en la libreta de direcciones del espacio de trabajo. La dirección es la identidad, así que no hay ningún id que elegir ni ninguno en la respuesta. Se recortan sus espacios y se pasa a minúsculas antes de almacenarla, y el contacto se guarda con `source` en `manual`. El contacto nuevo entra en la audiencia por defecto integrada según se escribe, además de en lo que se nombre en `audienceIds`.
Ejecuta la llamada real contra tu espacio de trabajo, con tu propia clave.
POST /contacts
Guarda una dirección en la libreta de direcciones del espacio de trabajo. La dirección es la identidad, así que no hay ningún id que elegir ni ninguno en la respuesta. Se recortan sus espacios y se pasa a minúsculas antes de almacenarla, y el contacto se guarda con source en manual. El contacto nuevo entra en la audiencia por defecto integrada según se escribe, además de en lo que se nombre en audienceIds.
Ejemplo
Requiere contacts:write. Enviar audienceIds requiere además 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 dirección que ya está en la libreta es un 409 contact_exists y no una fusión, así que un reintento no puede sobrescribir en silencio un nombre que alguien editó en la aplicación. Lee la fila y aplícale un PATCH en su lugar.
lastSeenAt se queda en null hasta que sale correo hacia la dirección desde el redactor de la aplicación. source y lastSeenAt son del servidor y no se aceptan en el cuerpo.
Un id de audiencia en audienceIds que no existe en este espacio de trabajo es un 404 y no se escribe nada.