API

Сохранение контакта

Делает то же, что «Добавить в контакты» и «Оставить в контактах» в приложении, и безопасен при любом состоянии адреса. Адрес, который ещё не контакт, становится контактом, с ответом `201`. Записанный при отправке становится `manual`, а уже сохранённый сохраняет то, что у него есть, с ответом `200`. Удалённый адрес возвращается. Тело необязательно.

PUTapi.openemail.uk/contacts/{email}

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

PUT /contacts/{email}

Делает то же, что «Добавить в контакты» и «Оставить в контактах» в приложении, и безопасен при любом состоянии адреса. Адрес, который ещё не контакт, становится контактом, с ответом 201. Записанный при отправке становится manual, а уже сохранённый сохраняет то, что у него есть, с ответом 200. Удалённый адрес возвращается. Тело необязательно.

Пример

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

curl

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 заменяет сохранённое имя, а если его не передать, оно остаётся. notes заменяет сохранённые заметки, а null их очищает. Любой другой ключ даёт 422 unknown_parameter.

В отличие от POST /contacts, адрес, который уже есть в книге, не даёт 409; в отличие от PATCH, адрес, которого нет в книге, не даёт 404. Новый контакт попадает в аудиторию по умолчанию.