API
署名を作成する
アドレスまたはキャッチオールに名前付きの署名を追加します。
POST/signatures
実際の呼び出しをワークスペースに対して実行します。
POST /signatures
アドレスまたはキャッチオールに名前付きの署名を追加します。
例
settings:write が必要です。address、name、html は必須です。
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"}HTML は送信メールと同じ方法でサニタイズされるため、返ってくるものは送ったものと異なる場合があり、テキストか画像が残っている必要があります。サニタイズの前後とも最大 150,000 文字で、超えると呼び出しは 422 signature_too_long になります。
アドレスの最初の署名は、isDefault または isReplyDefault が false でない限り、新規メールと返信の既定になります。それより後の署名は指定したときだけ既定になり、その場合はそれまで既定だった署名から役割を引き継ぎます。
name は 1 文字から 80 文字で、大文字と小文字を区別せず、そのアドレスの中で一意です。アドレスがすでに使っている名前は 409 signature_name_taken になります。1 つのアドレスに置ける署名は最大 50 個で、それを超えると 422 signature_limit_reached になります。
アドレスは、ワークスペースのアドレスか、ここで検証済みのドメインにあり、キャッチオールがオンになっているキャッチオールでなければなりません。ドメイン全体を含め、それ以外はすべて 422 invalid_parameter になります。