Waar vind je de API?

Ga naar Instellingen → API. De pagina heeft drie tabbladen: Keys, Webhooks en Activiteit. Alleen gebruikers met de rol Eigenaar zien deze pagina.

  • Basis-URL: https://api.v2.xendy.me/v1
  • Documentatie (OpenAPI): https://api.v2.xendy.me/v1/openapi.json. Die open je zonder API-key en kun je inladen in tools als Postman.

Een API-key aanmaken

  1. Klik op het tabblad Keys op API key aanmaken.
  2. Geef de key een herkenbare Naam, bijvoorbeeld Koppeling webshop.
  3. Kies per datatype wat de key mag: Lezen en/of Schrijven. Geef niet meer rechten dan je koppeling nodig heeft.
  4. Klik op Aanmaken. Kopieer de key en klik op Ik heb de waarde opgeslagen. Je ziet de key maar één keer.

Stuur de key mee in elke aanvraag als header: Authorization: Bearer xnd_live_.... De key bepaalt automatisch over welk account het gaat.

DatatypeLezenSchrijven
ContactenContacten ophalenContacten aanmaken, bijwerken, in- en uitschrijven en aan een lijst toevoegen of eruit halen
Mail lists & audiencesLijsten en segmenten ophalenEen lijst aanmaken
CampagnesCampagnes ophalen–
Versturen–Een bestaande campagne als nieuwsbrief versturen of inplannen
RapportagesStatistieken van nieuwsbrieven en automations ophalen–
AccountHet token voor verlaten winkelwagens (nodig voor de WordPress-plugin)–
WebhooksWebhooks ophalenWebhooks registreren en verwijderen

Let op: met Versturen (schrijven) kan de key echte nieuwsbrieven naar je contacten sturen. Zet dit alleen aan als je koppeling dat moet kunnen.

Een API-key intrekken

In de lijst met keys zie je per key de Rechten en wanneer hij voor het laatst is gebruikt (Laatst gebruikt). Wil je een key niet meer gebruiken, klik dan op het prullenbak-icoon onder Verwijderen en bevestig. Koppelingen die de key gebruiken, stoppen direct met werken. Dit kun je niet ongedaan maken.

Webhooks: Xendy stuurt jou een bericht

Met een webhook stuurt Xendy automatisch een POST-verzoek naar jouw URL als er iets gebeurt. Je kiest uit drie events:

  • DNS-records niet meer correct (dns-records.failed)
  • DNS-records hersteld (dns-records.recovered)
  • Webshop-import mislukt (webshop-import.failed)
  1. Klik op het tabblad Webhooks op Webhook toevoegen.
  2. Vul de URL in (alleen https) en kies de Events.
  3. Klik op Toevoegen. Kopieer het webhook-secret dat verschijnt: je ziet het maar één keer.

Elk bericht is JSON met id, event, created_at en data, en heeft de headers Xendy-Event, Xendy-Delivery en Xendy-Signature. Met de handtekening controleer je dat het bericht echt van Xendy komt. Xendy-Signature heeft de vorm t=<tijdstip>,v1=<handtekening>: de handtekening is een HMAC-SHA256 van <t>.<body> met jouw secret. Weiger berichten waarvan t ouder is dan 5 minuten. Een voorbeeld in JavaScript staat in de documentatie.

Antwoord binnen 10 seconden met een 2xx-statuscode. Lukt de bezorging niet, dan probeert Xendy het opnieuw na 1, 5 en 30 minuten. Mislukken vijf events achter elkaar helemaal, dan zet Xendy de webhook op Uitgeschakeld. Elke poging zie je terug op het tabblad Activiteit, onder Uitgaande webhook.

Limieten

  • 120 aanvragen per minuut per key
  • Schrijfacties: 60 per minuut
  • Versturen: 10 per minuut

Ga je daarboven, dan krijg je HTTP 429. Stuur bij het versturen van een nieuwsbrief een Idempotency-Key-header mee: binnen 24 uur geeft dezelfde waarde dezelfde nieuwsbrief terug, in plaats van een tweede verzending.

Veelgestelde vragen

Nee. Xendy toont een key maar één keer en bewaart hem niet leesbaar. Maak een nieuwe key aan, zet die in je koppeling en trek daarna de oude in.

Nee. Een API-key (xnd_live_...) werkt alleen op de API en een MCP-key (xnd_mcp_...) alleen voor AI-assistenten via MCP. Met een MCP-key krijg je op de API de foutcode 401.

Dan zijn vijf events achter elkaar niet bezorgd, ook niet na de herhaalpogingen. Op het tabblad Activiteit (soort Uitgaande webhook) zie je wat je server antwoordde. Los het probleem op, verwijder de webhook en voeg hem opnieuw toe.

Op het tabblad Webhooks stel je berichten in die Xendy naar jouw systeem stuurt. Wil je zelf contacten naar Xendy sturen, gebruik dan in een segment Contacten toevoegen → Via een webhook. Dat werkt met een eigen token in plaats van een API-key. Zie Via Zapier koppelen.

Op het tabblad Activiteit zie je elke aanroep met status, duur en de verstuurde gegevens. Zie API-activiteit bekijken.

Joeri Ras

Geschreven door

Joeri Ras

Oprichter & mede-eigenaar @ Xendy

Liever direct contact?

Gerelateerde artikelen

Koppelingen

Gravity Forms koppelen aan Xendy

Met Gravity Forms maak je eenvoudig formulieren in WordPress. Door de koppeling met Xendy komen inzendingen automatisch in een statisch segment terecht, zodat je nieuwe contacten direct kunt gebruiken voor nieuwsbrieven of e-mail automations.

Lees meer
Koppelingen

Lightspeed webshop koppelen aan Xendy

Door Lightspeed aan Xendy te koppelen, worden klant-, bestel- en productgegevens automatisch elke nacht gesynchroniseerd. Zo kun je segmenten maken op basis van aankoopgedrag en producten direct in je e-mails tonen. Met twee scripts in je webshop volg je ook verlaten winkelwagens op.

Lees meer
Koppelingen

Magento 2 webshop koppelen aan Xendy

Door Magento 2 aan Xendy te koppelen worden klant-, bestel- en productgegevens automatisch elke nacht gesynchroniseerd. Zo kun je segmenten maken op basis van koopgedrag, persoonlijke productaanbevelingen tonen en verlaten winkelwagens opvolgen. Let op: verlaten winkelwagens werken bij Magento 2 alleen voor klanten die ingelogd zijn in je webshop. Xendy haalt ze op tijdens de nachtelijke import.

Lees meer
Koppelingen

Shopify webshop koppelen aan Xendy

Door Shopify aan Xendy te koppelen, komen je klanten, bestellingen en producten in Xendy. Zo kun je segmenten maken op basis van koopgedrag en producten in je e-mails zetten. Je koppelt via de Xendy-app in Shopify of met een eigen app uit het Shopify Dev Dashboard. Via de Xendy-app komen wijzigingen direct binnen, werken verlaten winkelwagens en gaan uitschrijvingen twee kanten op. Met een eigen app worden je gegevens elke nacht bijgewerkt.

Lees meer