Erste Schritte
Schnellstart: die erste Nachricht senden
Mit der WeZend-API in etwa fünf Minuten von null zur zugestellten Nachricht.
Diese Anleitung versendet Ihre erste Nachricht in etwa fünf Minuten.
1. API-Key abrufen
Melden Sie sich im Dashboard an, öffnen Sie Einstellungen → API-Keys und erstellen Sie einen Key. Er authentifiziert jede Anfrage, die Sie senden, und darf niemals in einem Browser oder einer mobilen App offengelegt werden — rufen Sie ihn aus Ihrem eigenen Backend auf.
Der Bestätigungslink ist es, der Ihr Konto anlegt.
POST /v1/auth/signupantwortet202und legt nichts an: das Konto — und sein erster API-Key — entsteht, wenn Sie dem Link folgen, den WeZend Ihnen mailt. Registrieren Sie sich mit einer geschäftlichen E-Mail-Adresse; private Postfächer (Gmail, Outlook, Yahoo, Proton) und temporäre Adressen werden abgewiesen, und die Firmenfelder sind Pflicht —POST /v1/auth/signup/lookup-vatfüllt sie aus dem USt-Register. Link verloren?POST /v1/auth/send-verify-emailschickt einen neuen, 24 Stunden gültig. Ein älteres Konto, das seine Adresse nie bestätigt hat, kann nicht senden, bis das geschieht: diese Nachrichten werden mit Statussuppressedund einem Grund angelegt, nicht eingereiht.
2. Nachricht senden
curl https://api.wezend.com/v1/messages/send \
-H "X-API-Key: $WEZEND_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"to": "+4512345678",
"channel": "sms",
"message": "Hallo von WeZend"
}'
Das Beispiel sendet bewusst ohne sender-Feld, sodass die Nachricht den Standardabsender Ihres Kontos verwendet — das funktioniert auf einem neuen Konto, sobald die E-Mail-Adresse bestätigt ist. Ein eigener sender (Ihr Markenname) muss zuerst unter Einstellungen → Absender-IDs freigegeben werden; ein nicht freigegebener Wert wird mit 403 abgelehnt.
Ein erfolgreicher Aufruf gibt 201 mit dem Nachrichtendatensatz zurück:
{
"message_id": "3fa1e2c0-...",
"status": "queued",
"channel": "sms",
"to": "+4512345678",
"cost": 0.045,
"currency": "EUR",
"created_at": "2026-07-08T10:00:00.000Z"
}
3. Zustellung prüfen
Fragen Sie GET /v1/messages/:message_id ab oder — bei realem Volumen die bessere Wahl — übergeben Sie eine webhook_url in der Sendeanfrage und erhalten Sie Zustellungsupdates in Echtzeit. Siehe Webhooks.
Vor der ersten echten E-Mail: Domain verifizieren
Der Versand oben geht unter WeZends gemeinsamem Standardabsender hinaus. Um unter Ihrer eigenen Domain zu senden — und aus dem Spam zu bleiben — fügen Sie sie zuerst unter Einstellungen → Domains hinzu (GET /v1/account/email-domains). WeZend erzeugt die exakten Records für Ihr Konto: ein SPF-include:, ein DKIM-CNAME unter WeZends eigenem Selector und ein empfohlenes DMARC beginnend bei p=none.
Veröffentlichen Sie den DKIM-Record unter dem Selector, den WeZend Ihnen nennt — nicht unter einem, den Ihr Mailhost schon für seine eigene Post nutzt. Das sind verschiedene Keys, und nur WeZends Selector passt zu der Signatur, die wir anbringen. Rufen Sie dann POST /v1/account/email-domains/:id/verify auf; das checks-Objekt nennt je Record, was bestanden hat und, wenn nicht, warum. Bleiben Sie bei p=none, bis DKIM verifiziert, und verschärfen Sie danach. Vollständige Anleitung: E-Mail: Domains, DNS & Versand.
Was aktiviert werden muss
Nicht alles ist Selbstbedienung, und es ist besser, das jetzt zu wissen als es später zu debuggen.
| Fähigkeit | Was nötig ist |
|---|---|
| Überhaupt ein Konto und ein API-Key | Folgen Sie dem Bestätigungslink aus der Registrierung (Schritt 1). Die Registrierung allein legt nichts an. |
| E-Mail unter Ihrer eigenen Domain | Domain verifizieren (oben). Bis dahin wird der gemeinsame Standardabsender verwendet. |
| SMS, RCS, WhatsApp, Voice | Eine Absender-ID und Routing, die im Onboarding mit Ihnen eingerichtet werden — keine Selbstbedienung. |
| Eingehende E-Mail (Antworten auf eine Kampagne) | Wird je Antwort-Subdomain im Onboarding aktiviert. |
| KI-Betreffzeilen und Umformulierungen | In jedem Plan. Degradiert elegant, wenn das KI-Backend nicht verfügbar ist. |
| AI Email Writer, Performance Coach | Bezahlte Add-ons — in der Abrechnung aktivieren. |
| Predictive Scores (Churn, CLV, Neigung) | Ab Business. Heuristische Scores funktionieren sofort; keine Trainingsdaten nötig. |
Sie brauchen keine Liste, um es funktionieren zu sehen. Der erste Schritt im Dashboard sendet eine echte Nachricht an die Adresse, die Sie bei der Registrierung bestätigt haben — ein Klick, kein Import, keine Kontakte. Sie läuft über den gewöhnlichen Sendeweg (
POST /v1/onboarding/send-test), wird also auf das Kontingent gezählt, geroutet, abgerechnet und auf die Timeline gelegt, genau wie Produktions-Traffic: was Sie sehen, ist was ein Kunde bekäme — keine Simulation. Der Kontakt-Import kann warten, bis sichtbar etwas funktioniert hat — und das ist die Reihenfolge, auf die es ankommt, denn wer überhaupt sendet, sendet innerhalb von Stunden nach der Registrierung.
Nächste Schritte
- Authentifizierung — API-Keys vs. Dashboard-Sessions
- Nachrichten senden — alle Felder, die
/v1/messages/sendakzeptiert, und Kanal-Fallback - Rate Limits — die tatsächlichen, aktuellen Limits pro Endpoint
Die Anfrage bauen
Füllen Sie die benötigten Felder aus und kopieren Sie die Anfrage als cURL, Node, Python oder PHP — sie erzeugt den Code, sie sendet nichts.
Bei SMS und RCS muss dies eine unter Einstellungen → Absender-IDs freigegebene Absender-ID sein — ein nicht freigegebener Wert wird mit 403 abgelehnt. Leer lassen, um den Konto-Standard zu verwenden, der immer funktioniert.
Leere Felder werden aus der Anfrage weggelassen. E-Mail-Felder erscheinen, wenn der Kanal E-Mail ist.
curl https://api.wezend.com/v1/messages/send \
-H "X-API-Key: $WEZEND_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"to": "+4512345678",
"channel": "sms",
"message": "Hello from WeZend"
}'Eine Plattform. Jede Kundeninteraktion.
Ersetzen Sie Ihren Flickenteppich aus Messaging-APIs, CDP und Automatisierungstools durch eine Engagement-Plattform, die für Skalierung gebaut ist.
Keine Kreditkarte · EU-Datenhaltung · 99,99 % Uptime-SLA