사용자 지정 헤더

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이 비슷한 메시지를 하나의 스레드로 묶거나 푸터를 숨기는 것을 막습니다.
`In-Reply-To`, `References`	메시지를 기존 대화 아래의 스레드로 연결합니다.
`X-*`	애플리케이션별 메타데이터. SMTP에서는 SpacePost 자체 제어 헤더인 `X-SpacePost-`를 제외한 `X-` 헤더가 그대로 전달됩니다.