Ir a la documentación
API

Crear una firma

Añade una firma con nombre a una dirección o a un catch-all.

POST/signatures

Ejecuta la llamada real en tu espacio de trabajo.

POST /signatures

Añade una firma con nombre a una dirección o a un catch-all.

Ejemplo

Requiere settings:write. address, name y html son obligatorios.

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  }'
Respuesta
{  "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"}

El HTML se sanea igual que el correo saliente, así que lo que vuelve puede diferir de lo que enviaste, y tiene que conservar algo de texto o una imagen. Admite como máximo 150.000 caracteres, antes y después del saneado, o la llamada es un 422 signature_too_long.

La primera firma de una dirección pasa a ser su predeterminada para el correo nuevo y para las respuestas salvo que isDefault o isReplyDefault diga false. Una posterior solo pasa a ser predeterminada cuando se pide, y entonces le quita ese puesto a la firma que lo tenía.

name tiene de 1 a 80 caracteres y es único en su dirección, sin distinguir mayúsculas. Un nombre que la dirección ya usa es un 409 signature_name_taken. Una dirección admite como máximo 50 firmas, y la siguiente es un 422 signature_limit_reached.

La dirección tiene que ser una del espacio de trabajo, o un catch-all de un dominio verificado aquí que tenga el catch-all activado. Cualquier otra cosa, incluido un dominio entero, es un 422 invalid_parameter.

Referencia