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

API 0.16.0OpenAPIllms-full.txt

POST/v1/mailboxes/{mailbox_id}/contacts

Сохраняет имя и адрес контакта в выбранном ящике. Если контакт с таким email уже существует, обновляет его имя без создания дубликата.

Авторизация и области доступа · Ошибки и повторы

Запрос

curl -X POST 'https://adapt-mail.com/v1/mailboxes/<mailbox_id>/contacts' \
  -H 'Authorization: Bearer <access_token>' \
  -H 'Content-Type: application/json' \
  --data '{"email":"[email protected]","name":"Support team"}'

Параметры

mailbox_idpathОбязательно

integer

X-Customer-IDheader

Вариант 1

string

Вариант 2

null

Тело запроса · application/json

object

emailОбязательно

string

nameОбязательно

string

minLength: 1

maxLength: 120

Неизвестные поля не принимаются.

Ответы

200 Успешный ответ

application/json

object

id

integer

mailbox_id

integer

email

string

name

string

created_at

string

Дата и время в UTC. Если смещение отсутствует, значение также представляет UTC.

401 Требуется вход

application/json

object

detail

Вариант 1

string

Вариант 2

object

code

string

message

string

Вариант 3

array

Элементы массива

object

403 Нет доступа

application/json

object

detail

Вариант 1

string

Вариант 2

object

code

string

message

string

Вариант 3

array

Элементы массива

object

404 Ресурс не найден

application/json

object

detail

Вариант 1

string

Вариант 2

object

code

string

message

string

Вариант 3

array

Элементы массива

object

409 Конфликт состояния

application/json

object

detail

Вариант 1

string

Вариант 2

object

code

string

message

string

Вариант 3

array

Элементы массива

object

422 Ошибка валидации

application/json

object

detail

array

Элементы массива

object

locОбязательно

array

Элементы массива

Вариант 1

string

Вариант 2

integer

msgОбязательно

string

typeОбязательно

string

503 Временная недоступность

application/json

object

detail

Вариант 1

string

Вариант 2

object

code

string

message

string

Вариант 3

array

Элементы массива

object