Wanneer je e-mailcampagnes uitvoert of contacten synchroniseert tussen je app en een ESP, heb je één duidelijke regel nodig: wie mag mail ontvangen en wie moet worden uitgesloten. verify-email.app vervangt niet de afmeldlink of wettelijke naleving van je ESP, maar het biedt je zwarte lijst en witte lijst regels die in elke verificatierespons als één enkel veld verschijnen: block. Je code kan block lezen voordat je verstuurt, een lijst importeert, of een account aanmaakt — zonder de toestaan/verbieden logica in elke dienst te kopiëren.

• Zwarte Lijst — Als de e-mail of het domein op je zwarte lijst staat, retourneert de API block: true. Gebruik dit voor mensen die zich hebben afgemeld, misbruikgevallen, of domeinen waar je nooit naar wilt mailen.

• Witte Lijst — Wanneer witte lijst modus aanstaat, krijgen alleen adressen (of hele domeinen) die je aan de witte lijst hebt toegevoegd block: false. Iedereen anders krijgt block: true. Gebruik dit voor gesloten lijsten — partners, uitnodigingen, interne bèta's — niet voor een normale nieuwsbrief waarbij "iedereen zich kan abonneren".

• Volgorde — Zwarte lijst wint. Als een adres is opgenomen in de zwarte lijst, blijft het geblokkeerd, zelfs als het ook in de witte lijst staat.

1. Wanneer een gebruiker zich afmeldt in je app of je een ESP webhook verwerkt, neem dan hun adres (of het domein dat je blokkeert volgens beleid).

2. Voeg het toe met POST /v1/blacklist en JSON body {"value": "[email protected]"} (of "example.com" om alle adressen op dat domein te blokkeren). Gebruik header X-API-Key met je API-sleutel.

3. Voordat je een campagne verstuurt of een rij naar je mailingtool pusht, verifieer het adres. Als block true is, sla die ontvanger dan over.

Om ze later weer toe te staan (bijv. ze hebben zich opnieuw aangemeld en bevestigd), verwijder de regel met DELETE /v1/[email protected].

1. Zet strikte alleen-toestaan modus aan: PUT /v1/whitelist/enabled met body {"enabled": true}.

2. Voeg elk goedgekeurd adres of domein toe: POST /v1/whitelist met {"value": "[email protected]"} of {"value": "company.com"}.

3. Bij verificatie, block: false betekent dat het adres is toegestaan onder je witte lijst; anderen worden geblokkeerd totdat je ze toevoegt.

Wanneer je de alleen-toestaan modus niet nodig hebt (bijv. openbare aanmeldingen keren terug), stel enabled weer in op false zodat de witte lijst iedereen anders niet meer beperkt.

De meeste producten slaan toestemming op in de ESP en houden daar een onderdruklijst bij. In verify-email.app verwijder je meestal het adres van de zwarte lijst als ze zich eerder hadden afgemeld (DELETE op zwarte lijst), en vertrouw je op je ESP voor de daadwerkelijke aanmeldstatus. Reserveer witte lijst voor processen waar alleen vooraf goedgekeurde e-mails mogen passeren.

Je kunt dezelfde regels beheren in het dashboard evenals via de API — zie de Zwarte Lijst en Witte Lijst pagina's op verify-email.app voor context en API details.