Guardar un contacto
Hace lo que hacen Añadir a contactos y Mantener en contactos en la app, y es seguro sea cual sea el estado de la dirección. Una dirección que aún no es un contacto pasa a serlo, con la respuesta `201`. Una registrada desde un envío pasa a `manual`, y una ya guardada conserva lo que tiene, con la respuesta `200`. Una dirección eliminada se recupera. El cuerpo es opcional.
Ejecuta la llamada real contra tu espacio de trabajo, con tu propia clave.
PUT /contacts/{email}
Hace lo que hacen Añadir a contactos y Mantener en contactos en la app, y es seguro sea cual sea el estado de la dirección. Una dirección que aún no es un contacto pasa a serlo, con la respuesta 201. Una registrada desde un envío pasa a manual, y una ya guardada conserva lo que tiene, con la respuesta 200. Una dirección eliminada se recupera. El cuerpo es opcional.
Ejemplo
Requiere contacts:write. Codifica el @ en la URL.
curl -X PUT "$OE/contacts/grace%40example.com" -H "$AUTH" -H 'content-type: application/json' -d '{ "name": "Grace Hopper"}'{ "object": "contact", "email": "[email protected]", "name": "Grace Hopper", "source": "manual", "notes": null, "photoUrl": null, "lastSeenAt": "2026-09-20T12:00:00.000Z", "createdAt": "2026-09-02T08:00:00.000Z", "updatedAt": "2026-09-23T10:15:00.000Z", "audiences": [ { "id": "aud_9f2c4b7e1a0d63d84c5f2e7b", "name": "All contacts", "builtin": "default" } ]}name sustituye el nombre guardado y omitirlo lo conserva. notes sustituye las notas guardadas y null las borra. Cualquier otra clave es un 422 unknown_parameter.
A diferencia de POST /contacts, una dirección que ya está en la libreta no es un 409; a diferencia de PATCH, una dirección que no está en la libreta no es un 404. Un contacto nuevo entra en la audiencia predeterminada.