Schnellstart

Diese Anleitung führt dich von null zu einer echten E-Mail, die von deiner eigenen Domain gesendet wird.

1. API-Schlüssel erstellen

   Öffne das Dashboard, gehe zu API-Schlüssel und klicke auf API-Schlüssel erstellen. Wähle full_access, solange du experimentierst. Kopiere den Schlüssel sofort: Er beginnt mit sp_live_ und wird nur einmal angezeigt.

   export SPACEPOST_API_KEY="sp_live_YOUR_API_KEY"

   Achtung

   Bewahre Schlüssel auf dem Server auf. Liefere sie nie in Browser- oder Mobile-Code aus. Erstelle pro Dienst einen sending_access-Schlüssel, damit du einen widerrufen kannst, ohne die anderen anzufassen.

2. Test-E-Mail senden

   Du kannst sofort ohne Domain senden, mit dem gemeinsamen Test-Absender onboarding@test.spacepost.dev. Er kann nur an die E-Mail-Adressen deiner eigenen Teammitglieder und an die Testadressen wie delivered@test.spacepost.dev zustellen.

   Node.js

   npm install @spacepost/node

   send.ts

   import { SpacePost } from "@spacepost/node";
   
   const spacepost = new SpacePost(process.env.SPACEPOST_API_KEY);
   
   const { data, error } = await spacepost.emails.send({
     from: "Acme <onboarding@test.spacepost.dev>",
     to: ["delivered@test.spacepost.dev"],
     subject: "Hello from SpacePost",
     html: "<strong>It works!</strong>",
   });
   
   if (error) {
     console.error(error); // { statusCode, name, message }
   } else {
     console.log("Sent", data.id);
   }

   cURL

   curl -X POST https://api.spacepost.dev/emails \
     -H "Authorization: Bearer $SPACEPOST_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "from": "Acme <onboarding@test.spacepost.dev>",
       "to": ["delivered@test.spacepost.dev"],
       "subject": "Hello from SpacePost",
       "html": "<strong>It works!</strong>"
     }'

   Python

   import os
   import requests
   
   r = requests.post(
       "https://api.spacepost.dev/emails",
       headers={"Authorization": f"Bearer {os.environ['SPACEPOST_API_KEY']}"},
       json={
           "from": "Acme <onboarding@test.spacepost.dev>",
           "to": ["delivered@test.spacepost.dev"],
           "subject": "Hello from SpacePost",
           "html": "<strong>It works!</strong>",
       },
   )
   print(r.status_code, r.json())

   Go

   package main
   
   import (
     "fmt"
     "io"
     "net/http"
     "os"
     "strings"
   )
   
   func main() {
     body := `{"from":"Acme <onboarding@test.spacepost.dev>","to":["delivered@test.spacepost.dev"],"subject":"Hello from SpacePost","html":"<strong>It works!</strong>"}`
     req, _ := http.NewRequest("POST", "https://api.spacepost.dev/emails", strings.NewReader(body))
     req.Header.Set("Authorization", "Bearer "+os.Getenv("SPACEPOST_API_KEY"))
     req.Header.Set("Content-Type", "application/json")
     res, err := http.DefaultClient.Do(req)
     if err != nil {
       panic(err)
     }
     defer res.Body.Close()
     out, _ := io.ReadAll(res.Body)
     fmt.Println(res.StatusCode, string(out))
   }

   Die Antwort lautet { "id": "0192e1c4-7a3b-7c1e-9d2f-3b5a8e6f4c10" }. Öffne die E-Mail im Dashboard, um ihre Zeitleiste zu sehen: sent, dann delivered.

3. Domain hinzufügen und verifizieren

   Um an beliebige Empfänger zu senden, sende von einer Domain, die dir gehört.

   curl -X POST https://api.spacepost.dev/domains \
     -H "Authorization: Bearer $SPACEPOST_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{ "name": "acme.com" }'

   Die Antwort listet die anzulegenden DNS-records auf: drei DKIM-CNAMEs sowie einen MX- und einen TXT-Eintrag für die Subdomain send (der eigene Return-Path). Lege sie bei deinem DNS-Anbieter an (Anleitungen für Cloudflare, Route 53 und weitere) und lass SpacePost dann prüfen:

   curl -X POST https://api.spacepost.dev/domains/$DOMAIN_ID/verify \
     -H "Authorization: Bearer $SPACEPOST_API_KEY"

   Oder überlass die Arbeit der CLI und beobachte das DNS live:

   npx spacepost domains doctor acme.com

   Die Verifizierung ist meist innerhalb von Minuten abgeschlossen. Der status der Domain wechselt auf verified, sobald DKIM bestätigt ist.

4. Von deiner Domain senden

   await spacepost.emails.send({
     from: "Acme <hello@acme.com>",
     to: ["you@example.com"],
     subject: "First real email",
     html: "<p>Sent from my own domain.</p>",
   });

Limits für neue Konten

In den ersten 7 Tagen kann ein neues Konto 100 E-Mails pro Tag senden. Siehe Konto-Sandbox.

Wie es weitergeht

Schnellstarts nach SpracheNext.js, Express, Hono, Python, Go, PHP, Ruby, Rust und mehr.

Webhooks einrichtenErfahre, wann E-Mails zugestellt, als Bounce zurückgewiesen oder geöffnet werden.

Best Practices für die ZustellbarkeitKomm in den Posteingang, nicht in den Spam-Ordner.