Перейти к документации
API

Создание подписи

Добавить подпись с названием для адреса или catch-all.

POST/signatures

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

POST /signatures

Добавить подпись с названием для адреса или catch-all.

Пример

Требуется settings:write. address, name и html обязательны.

curl
curl -X POST "$OE/signatures" -H "$AUTH" -H "Content-Type: application/json" \  -d '{    "address": "[email protected]",    "name": "Short",    "html": "<p>Ada<br>Acme Ltd</p>",    "isReplyDefault": true  }'
Ответ
{  "object": "signature",  "id": "sig_8f2c1a9b7d3e4f60a1b2c3d4",  "address": "[email protected]",  "name": "Short",  "html": "<p>Ada<br />Acme Ltd</p>",  "isDefault": false,  "isReplyDefault": true,  "createdAt": "2026-10-12T09:14:03.117Z",  "updatedAt": "2026-10-12T09:14:03.117Z"}

HTML очищается так же, как исходящая почта, поэтому вернувшееся может отличаться от отправленного, и в нём должен остаться текст или изображение. Он принимает не более 150 000 символов, до и после очистки, иначе вызов даёт 422 signature_too_long.

Первая подпись адреса становится его подписью по умолчанию для новых писем и для ответов, если только isDefault или isReplyDefault не равен false. Более поздняя становится подписью по умолчанию, только когда об этом просят, и тогда забирает это место у подписи, которая его занимала.

name длиной от 1 до 80 символов и уникально в пределах своего адреса, без учёта регистра. Название, которое адрес уже использует, даёт 409 signature_name_taken. У адреса может быть не больше 50 подписей, а следующая даёт 422 signature_limit_reached.

Адрес должен быть адресом рабочего пространства или catch-all на верифицированном здесь домене, у которого catch-all включён. Всё остальное, включая целый домен, даёт 422 invalid_parameter.

Справочник