Zum Inhalt springen

Node.js

  1. Installiere das SDK.

    Terminal-Fenster
    npm install @spacepost/node
  2. Exportiere deinen API-Schlüssel.

    Terminal-Fenster
    export SPACEPOST_API_KEY="sp_live_YOUR_API_KEY"
  3. Sende eine 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);

    Führe es mit node send.ts aus (Node 22.6+ entfernt Typen) oder mit npx tsx send.ts.

Das SDK wirft bei API-Fehlern nie eine Exception: Prüfe bei jedem Aufruf error. Es nutzt das globale fetch und läuft daher ab Node 18.

Die vollständige Referenz des Node.js SDK findest du hier.