Toggle sidebar

Blacklist-endpoints

Met de Blacklist-endpoints haal je op welke e-mailadressen niet meer gemaild mogen worden - voor je hele account, of voor één specifieke vragenlijst.

Endpoints

Methode Pad Beschrijving
GET /api/v1/blacklist Account-brede afmeldingen (adressen die voor álle vragenlijsten zijn afgemeld)
GET /api/v1/surveys/{survey}/blacklist Adressen die specifiek voor die vragenlijst zijn afgemeld

Account-brede blacklist

GET /api/v1/blacklist
Authorization: Bearer <token>
Accept: application/json

Geeft alle adressen terug die op accountniveau zijn afgemeld. Adressen die alleen voor één specifieke vragenlijst zijn afgemeld (en dus voor andere vragenlijsten nog wel mogen worden gemaild), staan hier niet in.

Vragenlijst-specifieke blacklist

GET /api/v1/surveys/123/blacklist
Authorization: Bearer <token>
Accept: application/json

Geeft de adressen die voor specifiek die vragenlijst zijn uitgesloten.

Response-velden

Per blacklist-regel krijg je:

  • email - het uitgesloten e-mailadres
  • created_at - wanneer de afmelding is geregistreerd

Voorbeeld-response

{
  "data": [
    {
      "email": "afgemelde@voorbeeld.nl",
      "created_at": "2026-03-15T14:22:01.000000Z"
    },
    {
      "email": "anders@voorbeeld.nl",
      "created_at": "2026-04-02T09:14:55.000000Z"
    }
  ]
}

Gebruikssituaties

  • Synchroniseren naar je CRM of mailtool: voorkom dat een afgemeld adres elders alsnog mails krijgt vanuit Mach3Forms.
  • Compliance-rapportage: een periodieke export laat zien welke adressen op welke datum zijn afgemeld - handig voor AVG-audits.
  • Pre-check vóór een batch: controleer voor je een batch met deelnemers importeert of er adressen tussen zitten die al op de blacklist staan.
Tip: respecteer afmeldingen overal

Een adres dat op deze blacklist staat, heeft expliciet aangegeven geen mail meer te willen ontvangen. Sluit dat ook uit in andere mailingsystemen die je naast Mach3Forms gebruikt.

Veelgestelde vragen

Op dit moment niet - alleen lezen. Adressen toevoegen doe je via de admin-omgeving, of automatisch wanneer een deelnemer op de afmeldlink in een uitnodigingsmail klikt.

/api/v1/blacklist toont account-brede afmeldingen - adressen die voor alles zijn afgemeld. /api/v1/surveys/{survey}/blacklist toont specifiek de afmeldingen voor één vragenlijst.

Gebruik het created_at-veld voor de afmeldingsdatum. Door regelmatig op te halen en te vergelijken met je laatste sync, kun je nieuwe afmeldingen detecteren.
Users
Export