Wo findest du die API?

Gehe zu Einstellungen → API. Die Seite hat drei Tabs: Keys, Webhooks und Aktivität. Nur Benutzer mit der Rolle Eigentümer sehen diese Seite.

  • Basis-URL: https://api.v2.xendy.me/v1
  • Dokumentation (OpenAPI): https://api.v2.xendy.me/v1/openapi.json. Diese öffnest du ohne API-Key und kannst sie in Tools wie Postman laden.

Einen API-Key erstellen

  1. Klicke im Tab Keys auf API-Key erstellen.
  2. Gib dem Key einen aussagekräftigen Namen, zum Beispiel Webshop-Verbindung.
  3. Wähle pro Datentyp, was der Key darf: Lesen und/oder Schreiben. Vergib nicht mehr Rechte, als deine Verbindung benötigt.
  4. Klicke auf Erstellen. Kopiere den Key und klicke auf Ich habe den Wert gespeichert. Du siehst den Key nur einmal.

Sende den Key bei jeder Anfrage als Header mit: Authorization: Bearer xnd_live_.... Der Key bestimmt automatisch, um welches Konto es geht.

DatentypLesenSchreiben
KontakteKontakte abrufenKontakte erstellen, aktualisieren, an- und abmelden sowie zu einer Liste hinzufügen oder daraus entfernen
Mail-Listen & AudiencesListen und Segmente abrufenEine Liste erstellen
KampagnenKampagnen abrufen–
Versenden–Eine bestehende Kampagne als Newsletter versenden oder einplanen
BerichteStatistiken von Newslettern und Automations abrufen–
KontoDas Token für verlassene Warenkörbe (benötigt für das WordPress-Plugin)–
WebhooksWebhooks abrufenWebhooks registrieren und löschen

Achtung: Mit Versenden (Schreiben) kann der Key echte Newsletter an deine Kontakte senden. Aktiviere dies nur, wenn deine Verbindung das können muss.

Einen API-Key widerrufen

In der Liste der Keys siehst du pro Key die Rechte und wann er zuletzt verwendet wurde (Zuletzt verwendet). Möchtest du einen Key nicht mehr verwenden, klicke auf das Papierkorb-Symbol unter Löschen und bestätige. Verbindungen, die den Key verwenden, hören sofort auf zu funktionieren. Dies kann nicht rückgängig gemacht werden.

Webhooks: Xendy sendet dir eine Nachricht

Mit einem Webhook sendet Xendy automatisch eine POST-Anfrage an deine URL, wenn etwas passiert. Du wählst aus drei Events:

  • DNS-Einträge nicht mehr korrekt (dns-records.failed)
  • DNS-Einträge wiederhergestellt (dns-records.recovered)
  • Webshop-Import fehlgeschlagen (webshop-import.failed)
  1. Klicke im Tab Webhooks auf Webhook hinzufügen.
  2. Gib die URL ein (nur https) und wähle die Events.
  3. Klicke auf Hinzufügen. Kopiere das Webhook-Secret, das erscheint: du siehst es nur einmal.

Jede Nachricht ist JSON mit id, event, created_at und data und enthält die Header Xendy-Event, Xendy-Delivery und Xendy-Signature. Mit der Signatur überprüfst du, dass die Nachricht wirklich von Xendy stammt. Xendy-Signature hat die Form t=<Zeitpunkt>,v1=<Signatur>: Die Signatur ist ein HMAC-SHA256 von <t>.<body> mit deinem Secret. Weise Nachrichten ab, bei denen t älter als 5 Minuten ist. Ein Beispiel in JavaScript findest du in der Dokumentation.

Antworte innerhalb von 10 Sekunden mit einem 2xx-Statuscode. Gelingt die Zustellung nicht, versucht Xendy es nach 1, 5 und 30 Minuten erneut. Schlagen fünf Events nacheinander vollständig fehl, setzt Xendy den Webhook auf Deaktiviert. Jeden Versuch siehst du im Tab Aktivität unter Ausgehender Webhook.

Limits

  • 120 Anfragen pro Minute pro Key
  • Schreibaktionen: 60 pro Minute
  • Versenden: 10 pro Minute

Überschreitest du diese Grenzen, erhältst du HTTP 429. Sende beim Versenden eines Newsletters einen Idempotency-Key-Header mit: Innerhalb von 24 Stunden gibt derselbe Wert denselben Newsletter zurück, anstatt ihn ein zweites Mal zu versenden.

Häufig gestellte Fragen

Nein. Xendy zeigt einen Key nur einmal an und speichert ihn nicht lesbar. Erstelle einen neuen Key, trage ihn in deine Verbindung ein und widerrufe danach den alten.

Nein. Ein API-Key (xnd_live_...) funktioniert nur auf der API und ein MCP-Key (xnd_mcp_...) nur für KI-Assistenten über MCP. Mit einem MCP-Key erhältst du auf der API den Fehlercode 401.

Dann wurden fünf Events nacheinander nicht zugestellt, auch nicht nach den Wiederholungsversuchen. Im Tab Aktivität (Typ Ausgehender Webhook) siehst du, was dein Server geantwortet hat. Behebe das Problem, lösche den Webhook und füge ihn erneut hinzu.

Im Tab Webhooks richtest du Nachrichten ein, die Xendy an dein System sendet. Möchtest du selbst Kontakte an Xendy senden, verwende in einem Segment Kontakte hinzufügen → Über einen Webhook. Das funktioniert mit einem eigenen Token anstelle eines API-Keys. Siehe Über Zapier verbinden.

Im Tab Aktivität siehst du jeden Aufruf mit Status, Dauer und den gesendeten Daten. Siehe API-Aktivität einsehen.

Joeri Ras

Geschrieben von

Joeri Ras

Gründer & Mitinhaber @ Xendy

Lieber direkter Kontakt?

Verwandte Artikel

Integrationen

Gravity Forms verbinden

Mit Gravity Forms erstellst du ganz einfach Formulare in WordPress. Durch die Verbindung mit Xendy landen Einsendungen automatisch in einem statischen Segment, sodass du neue Kontakte direkt für Newsletter oder E-Mail-Automations nutzen kannst.

Mehr lesen
Integrationen

Lightspeed-Webshop verbinden

Durch die Verknüpfung von Lightspeed mit Xendy werden Kunden-, Bestell- und Produktdaten automatisch jede Nacht synchronisiert. So kannst du Segmente auf Basis des Kaufverhaltens erstellen und Produkte direkt in deinen E-Mails anzeigen. Mit zwei Skripten in deinem Webshop kannst du außerdem abgebrochene Warenkörbe nachverfolgen.

Mehr lesen
Integrationen

Magento 2 Webshop verbinden

Durch die Verbindung von Magento 2 mit Xendy werden Kunden-, Bestell- und Produktdaten automatisch jede Nacht synchronisiert. So kannst du Segmente auf Basis des Kaufverhaltens erstellen, persönliche Produktempfehlungen anzeigen und verlassene Warenkörbe nachverfolgen. Hinweis: Verlassene Warenkörbe funktionieren bei Magento 2 nur für Kunden, die in deinem Webshop eingeloggt sind. Xendy ruft sie während des nächtlichen Imports ab.

Mehr lesen
Integrationen

Shopify-Webshop verbinden

Durch die Verknüpfung von Shopify mit Xendy werden deine Kunden, Bestellungen und Produkte in Xendy importiert. So kannst du Segmente auf Basis des Kaufverhaltens erstellen und Produkte in deine E-Mails einfügen. Die Verknüpfung erfolgt entweder über die Xendy-App in Shopify oder mit einer eigenen App aus dem Shopify Dev Dashboard. Über die Xendy-App werden Änderungen sofort übernommen, verlassene Warenkörbe funktionieren und Abmeldungen werden in beide Richtungen synchronisiert. Mit einer eigenen App werden deine Daten jede Nacht aktualisiert.

Mehr lesen