Zur Dokumentation springen
API

Eine Signatur erstellen

Einer Adresse oder einem Catch-all eine benannte Signatur hinzufügen.

POST/signatures

Führt den echten Aufruf in Ihrem Workspace aus.

POST /signatures

Einer Adresse oder einem Catch-all eine benannte Signatur hinzufügen.

Beispiel

Benötigt settings:write. address, name und html sind Pflichtfelder.

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

Das HTML wird so bereinigt wie ausgehende Mail, was zurückkommt, kann sich also von dem unterscheiden, was Sie gesendet haben, und es muss etwas Text oder ein Bild behalten. Es nimmt höchstens 150.000 Zeichen, vor und nach der Bereinigung, sonst ergibt der Aufruf 422 signature_too_long.

Die erste Signatur einer Adresse wird ihr Standard für neue Mail und für Antworten, sofern isDefault oder isReplyDefault nicht false sagt. Eine spätere wird nur auf Wunsch ein Standard und übernimmt diesen Platz dann von der Signatur, die ihn hatte.

name hat 1 bis 80 Zeichen und ist an seiner Adresse eindeutig, ohne Beachtung der Groß- und Kleinschreibung. Ein Name, den die Adresse bereits verwendet, ergibt 409 signature_name_taken. Eine Adresse fasst höchstens 50 Signaturen, und die nächste ergibt 422 signature_limit_reached.

Die Adresse muss eine des Workspace sein oder ein Catch-all auf einer hier verifizierten Domain, deren Catch-all eingeschaltet ist. Alles andere, auch eine ganze Domain, ergibt 422 invalid_parameter.

Referenz