Créer une signature
Ajouter une signature nommée à une adresse ou à un catch-all.
Exécute le véritable appel sur votre espace de travail.
POST /signatures
Ajouter une signature nommée à une adresse ou à un catch-all.
Exemple
Nécessite settings:write. address, name et html sont obligatoires.
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"}Le HTML est assaini comme l'est le courrier sortant, donc ce qui revient peut différer de ce que vous avez envoyé, et il doit garder du texte ou une image. Il accepte au plus 150 000 caractères, avant et après l'assainissement, sinon l'appel donne un 422 signature_too_long.
La première signature d'une adresse devient sa signature par défaut pour les nouveaux messages et pour les réponses, sauf si isDefault ou isReplyDefault vaut false. Une signature ajoutée ensuite ne devient une signature par défaut que si on le demande, et prend alors cette place à la signature qui la détenait.
name compte de 1 à 80 caractères et est unique sur son adresse, quelle que soit la casse. Un nom que l'adresse utilise déjà donne un 409 signature_name_taken. Une adresse compte au plus 50 signatures, et la suivante donne un 422 signature_limit_reached.
L'adresse doit être une adresse de l'espace de travail, ou un catch-all sur un domaine vérifié ici dont le catch-all est activé. Tout le reste, un domaine entier compris, donne un 422 invalid_parameter.