태그는 이메일에 붙이는 { name, value } 쌍입니다. 이메일과 함께 저장되고, GET /emails/{id}로 반환되며, 해당 이메일의 모든 웹훅 페이로드에 그대로 포함됩니다(객체 형태, "tags": { "category": "welcome" }). SpacePost id를 따로 저장하지 않고도 이벤트를 내 데이터와 연결할 때 사용하세요.

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: "Welcome",
  html: "<p>Hi</p>",
  tags: [
    { name: "category", value: "welcome" },
    { name: "user_id", value: "u_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": "Welcome",
    "html": "<p>Hi</p>",
    "tags": [{ "name": "category", "value": "welcome" }, { "name": "user_id", "value": "u_1042" }]
  }'

X-SpacePost-Tags: category=welcome, user_id=u_1042

규칙

이메일당 최대 50개의 태그를 사용할 수 있습니다.
name과 value는 각각 1자 이상 256자 이하이며, ASCII 문자, 숫자, 밑줄, 대시(A-Z a-z 0-9 _ -)만 사용할 수 있습니다.
공백, 점, @, ASCII가 아닌 문자는 422로 거부됩니다. 이메일 주소 같은 값은 먼저 해시하거나 슬러그로 바꾸세요. 예를 들어 user_1042나 SHA-256 16진수 다이제스트를 사용합니다.