Saltar para a documentação
API

Copiar uma assinatura para outros endereços

Pôr a mesma assinatura noutros endereços, substituindo a que lá tiver o mesmo nome.

POST/signatures/{id}/copy

Executa a chamada real no seu espaço de trabalho.

POST /signatures/{id}/copy

Pôr a mesma assinatura noutros endereços, substituindo a que lá tiver o mesmo nome.

Exemplo

Requer settings:write. addresses aceita de 1 a 500 endereços ou catch-alls.

curl
curl -X POST "$OE/signatures/sig_8f2c1a9b7d3e4f60a1b2c3d4/copy" -H "$AUTH" -H "Content-Type: application/json" \  -d '{ "addresses": ["[email protected]", "[email protected]"], "isDefault": true }'
Resposta
{  "object": "list",  "data": [    {      "object": "signature",      "id": "sig_51c0a7e2b94d4c18a3f6e0d2",      "address": "[email protected]",      "name": "Short",      "html": "<p>Ada<br />Acme Ltd</p>",      "isDefault": true,      "isReplyDefault": false,      "createdAt": "2026-10-12T09:20:41.902Z",      "updatedAt": "2026-10-12T09:20:41.902Z"    },    {      "object": "signature",      "id": "sig_c9d4e1f07a2b4b6f9e3d5a81",      "address": "[email protected]",      "name": "Short",      "html": "<p>Ada<br />Acme Ltd</p>",      "isDefault": true,      "isReplyDefault": true,      "createdAt": "2026-10-12T09:20:41.955Z",      "updatedAt": "2026-10-12T09:20:41.955Z"    }  ]}

Um endereço que já tem uma assinatura com o mesmo nome, sem distinguir maiúsculas, fica com o HTML dela substituído, por isso copiar de novo depois de uma edição atualiza todas as cópias. Qualquer outro endereço recebe uma assinatura nova com esse nome.

Uma cópia passa a predefinida onde isDefault ou isReplyDefault for true, e as duas coisas num endereço que não tinha nenhuma assinatura. Se forem omitidos, as predefinições dos outros endereços ficam como estão. O endereço onde a assinatura já está é ignorado.

Cada cópia passa a ser uma assinatura própria, com o seu próprio id. As cópias são escritas um endereço de cada vez, por isso quando um endereço está cheio a chamada falha com 422 signature_limit_reached e os endereços anteriores ficam com a sua cópia.

Referência