Создание контакта
Сохраняет один адрес в адресной книге рабочего пространства. Адрес и есть идентификатор, поэтому выбирать id не нужно и в ответе его нет. Перед сохранением он обрезается по краям и приводится к нижнему регистру, а контакт сохраняется с `source`, равным `manual`. Новый контакт при записи попадает во встроенную аудиторию по умолчанию, а также во всё, что названо в `audienceIds`.
Выполняет настоящий запрос в вашем рабочем пространстве, с вашим собственным ключом.
POST /contacts
Сохраняет один адрес в адресной книге рабочего пространства. Адрес и есть идентификатор, поэтому выбирать id не нужно и в ответе его нет. Перед сохранением он обрезается по краям и приводится к нижнему регистру, а контакт сохраняется с source, равным manual. Новый контакт при записи попадает во встроенную аудиторию по умолчанию, а также во всё, что названо в audienceIds.
Пример
Требуется contacts:write. Для отправки audienceIds нужен ещё и 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" } ]}Адрес, уже имеющийся в книге, даёт 409 contact_exists, а не слияние, поэтому повтор запроса не сможет тихо затереть имя, которое кто-то отредактировал в приложении. Вместо этого прочитайте запись и обновите её через PATCH.
lastSeenAt остаётся null, пока на адрес не уйдёт письмо из редактора в приложении. source и lastSeenAt принадлежат серверу и в теле запроса не принимаются.
id аудитории в audienceIds, которого нет в этом рабочем пространстве, даёт 404, и ничего не записывается.