API

Обновление контакта

Частичное обновление, никогда не upsert. Поле, которое вы опустили, сохраняет записанное значение, а явный `null` очищает его, поэтому `{"notes": null}` опустошает заметки, а `{}` не меняет ничего. Адрес, которого нет в книге, даёт `404`.

PATCHapi.openemail.uk/contacts/{email}

Выполняет настоящий запрос в вашем рабочем пространстве, с вашим собственным ключом.

PATCH /contacts/{email}

Частичное обновление, никогда не upsert. Поле, которое вы опустили, сохраняет записанное значение, а явный null очищает его, поэтому {"notes": null} опустошает заметки, а {} не меняет ничего. Адрес, которого нет в книге, даёт 404.

Пример

Требуется contacts:write. Кодируйте @ в URL.

curl

curl -X PATCH "$OE/contacts/grace%40example.com" -H "$AUTH" -H 'content-type: application/json' -d '{  "name": "Grace Hopper",  "notes": null}'

Ответ

{  "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" }  ]}

Адрес здесь изменить нельзя. Он одновременно идентификатор, сегмент пути и уникальный ключ книги, поэтому перенос контакта на новый адрес — это удаление и создание.

Контакт, записанный автоматически, остаётся auto и после того, как вы дадите ему имя. Присвоение имени — не то же утверждение, что чьё-то сохранение контакта.

Членство в аудиториях не затрагивается. Для этого используйте маршруты аудиторий.