Erste Schritte

Schnellstart

API-Schlüssel erstellen, Domain verifizieren und eine kontrollierte E-Mail mit einer wiederholungssicheren Anfrage senden.

Bevor Sie beginnen

Create a SendHQ workspace and keep the dashboard open. You can verify a domain and create an API key before paying. Sending requires an active subscription: there is no free allowance, including to your own address. Choose a plan at pricing.

1. API-Schlüssel erstellen

Öffnen Sie im Dashboard API keys, wählen Sie einen aussagekräftigen Namen wie Production und kopieren Sie den Schlüssel, sobald er angezeigt wird. Speichern Sie ihn serverseitig in einem Secret Manager. SendHQ gibt den vollständigen Wert nie wieder aus.

.env
SENDHQ_API_KEY=re_your_key_here

2. Absenderdomain hinzufügen

Open Domains, add a domain you control, and publish the returned DKIM, SPF, DMARC, and domain verification records. Copy the records into your DNS host and click Verify. On Cloudflare, add them as DNS only (grey cloud). Add the records, then click Verify.

Do not publish a second SPF policy.If SPF already exists, merge SendHQ's SPF include (include:amazonses.com) into the existing v=spf1 value.

3. Auf die Verifizierung warten

Use the dashboard or POST /domains/:id/verify. DNS can move through pending, checking, and propagating before the sending identity is verified.

4. Kontrollierte Nachricht senden

curl
curl https://sendhq.cc/api/v1/emails \
  -H "Authorization: Bearer $SENDHQ_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: onboarding-user-42" \
  -d '{"from":"Acme <hello@example.com>","to":["owner@example.com"],"subject":"SendHQ is connected","html":"<h1>It works</h1><p>Your first controlled message was accepted.</p>","text":"It works. Your first controlled message was accepted."}'

Eine erfolgreiche Anfrage gibt eine SendHQ-E-Mail-ID, die Nachrichten-ID des Providers und die Thread-ID der Konversation zurück. Speichern Sie die SendHQ-ID zusammen mit dem Anwendungsereignis, das die E-Mail ausgelöst hat.

5. Ergebnisse verarbeiten

Eine angenommene API-Anfrage ist nicht dasselbe wie die Zustellung an den Empfänger. Rufen Sie /emails/:id/events ab oder nutzen Sie das Dashboard, um Events zu Zustellung, Bounce, Beschwerde, Ablehnung, Öffnung und Klick einzusehen.