Ir a la documentación
API

Actualizar un contacto

Una actualización parcial, nunca un upsert. Un campo que omites conserva su valor almacenado y un `null` explícito lo borra, así que `{"notes": null}` vacía las notas mientras que `{}` no cambia nada. Una dirección que no está en la libreta es un `404`.

PATCHapi.openemail.uk/contacts/{email}

Ejecuta la llamada real contra tu espacio de trabajo, con tu propia clave.

PATCH /contacts/{email}

Una actualización parcial, nunca un upsert. Un campo que omites conserva su valor almacenado y un null explícito lo borra, así que {"notes": null} vacía las notas mientras que {} no cambia nada. Una dirección que no está en la libreta es un 404.

Ejemplo

Requiere contacts:write. Codifica el @ en la URL.

curl
curl -X PATCH "$OE/contacts/grace%40example.com" -H "$AUTH" -H 'content-type: application/json' -d '{  "name": "Grace Hopper",  "notes": null}'
Respuesta
{  "object": "contact",  "email": "[email protected]",  "name": "Grace Hopper",  "source": "manual",  "notes": null,  "lastSeenAt": null,  "createdAt": "2026-09-18T09:00:00.000Z",  "updatedAt": "2026-09-18T09:04:00.000Z",  "audiences": [    { "id": "aud_9f2c4b7e1a0d63d84c5f2e7b", "name": "All contacts", "builtin": "default" }  ]}

La dirección no se puede cambiar aquí. Es la identidad, el segmento de la ruta y la clave única de la libreta, así que mover un contacto a una dirección nueva es una eliminación y una creación.

Un contacto registrado automáticamente sigue siendo auto después de que le pongas un nombre. Ponerle nombre no es la misma afirmación que alguien lo haya guardado.

La pertenencia a audiencias no se toca. Usa las rutas de audiencias para eso.