Aller au contenu

Node.js

  1. Installez le SDK.

    Fenêtre de terminal
    npm install @spacepost/node
  2. Exportez votre clé API.

    Fenêtre de terminal
    export SPACEPOST_API_KEY="sp_live_YOUR_API_KEY"
  3. Envoyez un e-mail.

    send.ts
    import { SpacePost } from "@spacepost/node";
    const spacepost = new SpacePost(); // reads SPACEPOST_API_KEY
    const { data, error } = await spacepost.emails.send({
    from: "Acme <hello@acme.com>",
    to: ["user@example.com"],
    subject: "Welcome to Acme",
    html: "<h1>Welcome</h1><p>Glad to have you.</p>",
    text: "Welcome. Glad to have you.",
    tags: [{ name: "category", value: "welcome" }],
    });
    if (error) {
    console.error(error.statusCode, error.name, error.message);
    process.exit(1);
    }
    console.log("Email id:", data.id);

    Lancez-le avec node send.ts (Node 22.6+ supprime les types) ou npx tsx send.ts.

Le SDK ne lève jamais d’exception sur les erreurs de l’API : vérifiez error à chaque appel. Il utilise le fetch global, il fonctionne donc sur Node 18+.

Voir la référence complète du SDK Node.js.