Zur Dokumentation springen
API

Eine Signatur auf andere Adressen kopieren

Dieselbe Signatur auf andere Adressen legen und dort die gleichnamige ersetzen.

POST/signatures/{id}/copy

Führt den echten Aufruf in Ihrem Workspace aus.

POST /signatures/{id}/copy

Dieselbe Signatur auf andere Adressen legen und dort die gleichnamige ersetzen.

Beispiel

Benötigt settings:write. addresses nimmt 1 bis 500 Adressen oder 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 }'
Antwort
{  "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"    }  ]}

Bei einer Adresse, die bereits eine Signatur mit demselben Namen hat, ohne Beachtung der Groß- und Kleinschreibung, wird deren HTML ersetzt, erneutes Kopieren nach einer Änderung bringt also jede Kopie auf den neuesten Stand. Jede andere Adresse bekommt eine neue Signatur mit diesem Namen.

Eine Kopie wird dort ein Standard, wo isDefault oder isReplyDefault true ist, und beides an einer Adresse, die gar keine Signatur hatte. Ohne Angabe bleiben die Standards der anderen Adressen, wie sie sind. Die Adresse, an der die Signatur schon liegt, wird übersprungen.

Jede Kopie ist von da an eine eigene Signatur mit eigener ID. Die Kopien werden Adresse für Adresse geschrieben, ist also eine Adresse voll, scheitert der Aufruf mit 422 signature_limit_reached, und die Adressen davor behalten ihre Kopie.

Referenz