Tags

Les tags sont des paires { name, value } attachées à un e-mail. Ils sont stockés avec l’e-mail, renvoyés par GET /emails/{id} et repris dans chaque payload de webhook de cet e-mail (sous forme d’objet, "tags": { "category": "welcome" }). Utilisez-les pour relier les événements à vos propres enregistrements sans stocker l’id SpacePost.

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

Règles

Jusqu’à 50 tags par e-mail.
name et value font chacun de 1 à 256 caractères et ne peuvent contenir que des lettres ASCII, des chiffres, des tirets bas et des tirets (A-Z a-z 0-9 _ -).
Les espaces, les points, @ et les caractères non ASCII sont rejetés avec un 422. Hachez ou transformez d’abord en slug les valeurs telles que les adresses e-mail, par exemple user_1042 ou un condensé SHA-256 en hexadécimal.