API-referentie

Domeinen

Beheer de verzendende domeinen voor je account. Je kunt alleen e-mail versturen vanuit een geverifieerd domein.

Alle domeinen ophalen

GET https://api.wesender.nl/domains
curl https://api.wesender.nl/domains \
  -H "Authorization: Bearer $WS_API_KEY"

Domeindetail

GET https://api.wesender.nl/domains/:id
curl https://api.wesender.nl/domains/dom_01hwxxxxxxxxxx \
  -H "Authorization: Bearer $WS_API_KEY"

Een domeinobject bevat de DNS-records die je moet instellen, en de verificatiestatus per record.

200 OK
{
  "id":         "dom_01hwxxxxxxxxxx",
  "object":     "domain",
  "name":       "mail.joudomein.nl",
  "status":     "verified",
  "region":     "eu-west",
  "created_at": "2026-01-15T10:30:00Z",
  "records": [
    {
      "type":  "TXT",
      "name":  "mail.joudomein.nl",
      "value": "v=spf1 include:spf.wesender.nl ~all",
      "valid": true
    },
    {
      "type":  "TXT",
      "name":  "wesender._domainkey.mail.joudomein.nl",
      "value": "v=DKIM1; k=rsa; p=MIGfMA0...",
      "valid": true
    }
  ]
}

Domein toevoegen

POST https://api.wesender.nl/domains
VeldTypeVereistBeschrijving
name string Ja Subdomein dat je wil gebruiken, bijv. mail.joudomein.nl.
curl -X POST https://api.wesender.nl/domains \
  -H "Authorization: Bearer $WS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "mail.joudomein.nl" }'

Verificatie opnieuw starten

POST https://api.wesender.nl/domains/:id/verify

Triggert een directe DNS-check. Handig als je de records net hebt ingesteld en niet wilt wachten op de automatische check (elke 5 minuten).

curl -X POST https://api.wesender.nl/domains/dom_01hwxxxxxxxxxx/verify \
  -H "Authorization: Bearer $WS_API_KEY"

Domein verwijderen

DELETE https://api.wesender.nl/domains/:id

Verwijdert het domein en alle bijbehorende DNS-records. E-mails vanuit dit domein worden daarna geweigerd.

curl -X DELETE https://api.wesender.nl/domains/dom_01hwxxxxxxxxxx \
  -H "Authorization: Bearer $WS_API_KEY"

Domeinstatussen

StatusBeschrijving
pending Domein toegevoegd, DNS-records nog niet ingesteld of nog niet gepropageerd.
verified Alle DNS-records kloppen. Klaar om e-mail te versturen.
failed DNS-verificatie mislukt. Controleer de records in je domeinbeheer.

Volgende stappen