カスタムヘッダー

headers は、文字列のキーと文字列の値からなるオブジェクトで、そのままメッセージに書き込まれます。

Node.js
cURL

import { SpacePost } from "@spacepost/node";

const spacepost = new SpacePost(process.env.SPACEPOST_API_KEY);

await spacepost.emails.send({
  from: "Acme <hello@acme.com>",
  to: "user@example.com",
  subject: "Weekly digest",
  html: "<p>...</p>",
  headers: {
    "List-Unsubscribe": "<https://acme.com/unsubscribe?u=1042>, <mailto:unsubscribe@acme.com>",
    "List-Unsubscribe-Post": "List-Unsubscribe=One-Click",
    "X-Entity-Ref-ID": "digest-2026-w43-1042",
  },
});

curl -X POST https://api.spacepost.dev/emails \
  -H "Authorization: Bearer $SPACEPOST_API_KEY" -H "Content-Type: application/json" \
  -d '{
    "from": "Acme <hello@acme.com>",
    "to": ["user@example.com"],
    "subject": "Weekly digest",
    "html": "<p>...</p>",
    "headers": {
      "List-Unsubscribe": "<https://acme.com/unsubscribe?u=1042>",
      "List-Unsubscribe-Post": "List-Unsubscribe=One-Click"
    }
  }'

よく使うヘッダー

ヘッダー	用途
`List-Unsubscribe` と `List-Unsubscribe-Post`	ワンクリックの配信停止（RFC 8058）。Gmail と Yahoo が大量送信者に要求しています。一斉配信では自動的に追加されます。
`X-Entity-Ref-ID`	メールごとに一意の値。Gmail が似たメッセージを 1 つのスレッドにまとめたり、フッターを隠したりするのを防ぎます。
`In-Reply-To`、`References`	メッセージを既存の会話のスレッドにまとめます。
`X-*`	アプリケーション固有の任意のメタデータ。SMTP では、SpacePost 独自の `X-SpacePost-` 制御ヘッダーを除き、`X-` ヘッダーが転送されます。