API

テンプレートを作成する

公開を明示しない限り下書きになります。下書きはプレビューできますが、送信はできません。

POSTapi.openemail.uk/templates

実際の呼び出しを、ご自身のキーで自分のワークスペースに対して実行します。

POST /templates

公開を明示しない限り下書きになります。下書きはプレビューできますが、送信はできません。

例

templates:write が必要です。201 を返します。slug は省略すると名前から導出され、コードに固定すべきハンドルはこちらです。名前のほうは、誰かが変えてしまうものだからです。

curl

curl -X POST "$OE/templates" -H "$AUTH" -H "Content-Type: application/json" \  -d '{    "name": "Order shipped",    "engine": "html",    "subject": "Order {{orderId}} is on its way",    "html": "<p>Hello {{customer}}, {{orderId}} left the warehouse.</p>",    "props": [      { "key": "orderId", "kind": "text", "required": true },      { "key": "customer", "kind": "text", "default": "there" }    ],    "publish": true  }'

レスポンス

{  "object": "template",  "id": "tpl_9c1f0a4b7e05d3862c1f0a44",  "name": "Order shipped",  "slug": "order-shipped",  "description": null,  "status": "active",  "publishedVersion": 1,  "latestVersion": 1,  "subject": "Order {{orderId}} is on its way",  "engine": "html",  "slots": [],  "props": [    { "key": "orderId", "kind": "text", "required": true, "default": null },    { "key": "customer", "kind": "text", "required": false, "default": "there" }  ],  "createdAt": "2026-08-30T10:41:02.000Z",  "updatedAt": "2026-08-30T10:41:02.000Z"}

デプロイスクリプトからは publish: true を指定してください。指定しないとバージョン 1 が下書きとして作られます。これは人がまず文面を読む場合には正しく、自動化されたものの中では誤りです。

名前の重複は template_name_taken、slug の重複は template_slug_taken で、どちらもアカウント単位ではなく接続単位の 409 です。

1 つの接続が持てるテンプレートは 200 件です。201 件目は template_limit_reached で、これはプランの上限ではなく暴走スクリプトに対する防御です。