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.
SENDHQ_API_KEY=re_your_key_here2. 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.
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 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.