E-mail-API's · 21 september 2026
Het gratis abonnement van SendGrid is verdwenen: migreren in 30 minuten
De gratis tier van SendGrid is nu een proefperiode van 60 dagen. Een technische gids voor engineers om hun transactionele e-mail zonder downtime te migreren naar een duurzaam alternatief.
Het einde van de altijd-gratis tier
Gebruikte je het gratis abonnement van SendGrid voor een zijproject met weinig volume of een nieuw product, dan heb je de verandering waarschijnlijk gemerkt: de gratis tier is nu een proefperiode van 60 dagen. Na afloop daarvan moet je overstappen op een betaald abonnement, met Essentials vanaf 19.95 USD per maand (prijzen van SendGrid). Om te migreren exporteer je je suppressies, werk je je DNS-records bij en vervang je je API-integratie. Met eenvoudige templates kost dat ongeveer 30 minuten.
Je alternatieven beoordelen
Maak bij het kiezen van een vervanger onderscheid tussen acceptatie door de provider (de API accepteert je request), bezorging (de ontvangende server accepteert de e-mail) en inboxplaatsing (de e-mail blijft uit de spammap). Dat laatste kan geen enkele provider garanderen, want het hangt af van je afzenderreputatie en je inhoud.
Het kostenlandschap (september 2026)
Voor transactionele e-mail met weinig volume is het prijsverschil aanzienlijk. 50.000 e-mails versturen kost ongeveer 5 USD bij Amazon SES a la carte, tegenover ongeveer 66 USD bij de staffels van Postmark.
- Amazon SES: kost a la carte 0.10 USD per 1.000 e-mails (prijzen van AWS SES). De nieuwe abonnementen met staffels, ingevoerd op 21 juli 2026, zijn Essentials (0.16 USD per 1.000), Pro (0.22 USD per 1.000 plus 105 USD per maand per regio) en Enterprise (0.23 USD per 1.000 plus 500 USD per maand).
- Resend: biedt een gratis tier van 3.000 e-mails per maand, met een maximum van 100 per dag. Het Pro-abonnement kost 20 USD per maand voor 50.000 e-mails, met overschrijdingen tegen 0.90 USD per 1.000 (prijzen van Resend).
- Mailgun: vanaf 15 USD per maand voor 10.000 e-mails, met overschrijdingen van 1.80 tot 1.10 USD per 1.000 (prijzen van Mailgun).
- Postmark: vanaf 15 USD per maand voor 10.000 e-mails, met overschrijdingen van 1.80 tot 1.20 USD per 1.000 (prijzen van Postmark).
- SendHQ: een modern alternatief voor productteams en AI-agents, met de nadruk op privacyvriendelijke telemetrie die alleen in de EU blijft en API-sleutels per workspace.
Stap 1: data en suppressielijsten exporteren
Migreer je lijst niet zonder je suppressies te exporteren. Verstuur je naar een adres dat eerder een bounce gaf of zich heeft afgemeld, dan riskeer je schade aan je reputatie bij de nieuwe provider.
Bij SendGrid kun je je suppressielijst exporteren via de UI of de API. Je krijgt een CSV met e-mailadressen die je niet mag benaderen. Zorg er bij het importeren bij een nieuwe provider voor dat je de "reason" (bounce of afmelding) correct mapt, zodat je blijft voldoen aan wetgeving zoals de AVG (GDPR) of CAN-SPAM.
Stap 2: DNS en authenticatie
Hier gaan de meeste migraties mis. Je kunt niet simpelweg de API-sleutel wijzigen; je moet bij de nieuwe provider aantonen dat het domein van jou is.
DKIM, SPF en DMARC
Je moet nieuwe CNAME- of TXT-records toevoegen bij je DNS-provider. Stap je over naar SendHQ, dan kun je met de E-mail-DNS-checker je huidige configuratie controleren voordat je iets wijzigt.
- SPF: Werk je SPF-record bij zodat de nieuwe provider erin staat. Gebruik je meerdere providers, onthoud dan dat je niet meerdere SPF-TXT-records mag hebben. Je moet ze samenvoegen tot één record (bijvoorbeeld
v=spf1 include:sendgrid.net include:_spf.sendhq.cc ~all). Meer weten? Bekijk het begrip SPF in de begrippenlijst. - DKIM: Genereer nieuwe DKIM-sleutels in het dashboard van je nieuwe provider en voeg de CNAME-records die je krijgt toe aan je DNS. Zo kan de ontvangende server controleren dat er onderweg niet met de e-mail is geknoeid.
- DMARC: Je DMARC-beleid blijft hetzelfde, ongeacht de provider, want het is een beleid op domeinniveau. Zorg er wel voor dat je nieuwe provider aligned is met je DMARC-beleid, zodat e-mails niet worden geweigerd. Zie de gids over DKIM, SPF en DMARC voor de details van de implementatie.
Stap 3: code migreren
De meeste providers gebruiken een REST API. Gebruikte je de dynamische templates van SendGrid, dan moet je die HTML/CSS-layouts overzetten naar de template-engine van je nieuwe provider.
Voorbeeld: van SendGrid naar een generieke REST API
SendGrid gebruikt een specifieke JSON-structuur voor personalizations. De meeste moderne API's, waaronder SendHQ, geven de voorkeur aan een plattere structuur die beter leesbaar is.
Payload bij SendGrid:
{
"personalizations": [
{
"to": [{"email": "user@example.com"}],
"dynamic_template_data": {
"first_name": "Alice"
}
}
],
"from": {"email": "noreply@yourdomain.com"},
"template_id": "d-12345"
}
Payload bij een moderne API (bijvoorbeeld SendHQ):
{
"to": "user@example.com",
"from": "noreply@yourdomain.com",
"template_id": "welcome-email",
"variables": {
"first_name": "Alice"
}
}
De migratie in code afhandelen
Implementeer een wrapper of een strategy pattern om downtime te voorkomen. Zo kun je met een omgevingsvariabele tussen providers schakelen.
interface EmailProvider {
send(payload: EmailPayload): Promise<void>;
}
class SendGridProvider implements EmailProvider {
async send(payload: EmailPayload) {
// SendGrid specific implementation
}
}
class SendHQProvider implements EmailProvider {
async send(payload: EmailPayload) {
// SendHQ specific implementation
}
}
const provider = process.env.EMAIL_PROVIDER === 'sendhq'
? new SendHQProvider()
: new SendGridProvider();
Stap 4: AI-agents en idempotentie
Laat je e-mails door AI-agents triggeren, dan loop je een specifiek risico: de agent kan door een time-out in een lus raken of een request meerdere keren opnieuw proberen, waardoor de gebruiker tien identieke e-mails krijgt.
Een e-mail versturen is een extern side effect. Je moet idempotentie implementeren. Een idempotentiesleutel is een unieke identifier in de header die tegen de API zegt: "Als je deze sleutel al hebt gezien, verstuur de e-mail dan niet opnieuw, maar geef gewoon de oorspronkelijke succesrespons terug."
Implementatie die klaar is voor agents:
{
"headers": {
"Idempotency-Key": "order_123_welcome_email"
},
"body": {
"to": "customer@example.com",
"template_id": "order-confirmation"
}
}
Richt daarnaast voor riskante acties van agents (zoals het versturen van een wachtwoordreset of een factureringsmelding) een goedkeuringsstap met een mens in de lus in, of een strikte rate limit per gebruikers-ID, zodat hallucinaties van een agent je klanten niet kunnen overspoelen met e-mail.
Stap 5: testen en valideren
Loop deze checklist door voordat je de omgevingsvariabele naar de nieuwe provider omzet:
- DNS-propagatie: Gebruik een tool als
digof een webgebaseerde checker om te controleren of je nieuwe DKIM- en SPF-records live zijn. - Webhooks controleren: Vertrouw je op bezorgevents (delivered, opened, clicked), werk dan je webhook-endpoints bij. Het eventformaat van SendGrid wijkt af van dat van anderen. Zorg dat je endpoint het nieuwe JSON-schema aankan zonder te crashen.
- Foutafhandeling: Test hoe je applicatie omgaat met providerspecifieke fouten. Zo hoort een 429 (Too Many Requests) een backoffstrategie te starten, terwijl een 400 (Bad Request) meestal wijst op een ongeldig e-mailadres dat je in je database als bounce moet markeren.
Veelvoorkomende foutgevallen om te testen
- Ongeldig e-mailformaat: Zorg dat de API een duidelijke fout teruggeeft en dat je code niet eindeloos opnieuw probeert.
- Rate limiting: Simuleer een piek aan e-mails om te zien of je queue de limieten van de provider aankan.
- Grote bijlagen: Controleer de maximale payloadgrootte van de nieuwe provider. Sommige beperken je tot 10MB, andere tot 25MB.
Samenvattende checklist voor de migratie
- Suppressies exporteren: CSV-export uit SendGrid.
- DNS-records instellen: SPF-, DKIM- en DMARC-alignment.
- Templates migreren: Converteer HTML/CSS naar de nieuwe indeling.
- API-logica bijwerken: Implementeer een providerwrapper.
- Idempotentie toevoegen: Essentieel voor triggers van AI-agents.
- Webhooks testen: Verifieer eventbezorging en parsen.
- Verkeer omschakelen: Werk de ENV-variabele bij en monitor logs.
Tot slot: deliverability
Een providerwissel is een goed moment om je verzendgewoonten door te lichten. Onthoud dat acceptatie door de provider pas de eerste horde is. Bezorging hangt ervan af of de ontvangende ISP (Gmail, Outlook enzovoort) de verbinding accepteert. Inboxplaatsing is de laatste horde en wordt bepaald door de reputatie van je domein op de lange termijn en de betrokkenheid van je ontvangers.
Weersta de verleiding om deze API's te gebruiken voor ongevraagde bulkmail. Dat is niet alleen vaak illegaal, het leidt ook tot opschorting van je account, welke provider je ook kiest. Houd het bij transactionele communicatie waarvoor ontvangers toestemming hebben gegeven, zodat je sender score gezond blijft.
Bouw je AI-native applicaties, kies dan providers met functies voor agent readiness, zoals MCP-servers en llms.txt-bestanden, zodat de integratie soepel verloopt. SendHQ is precies voor deze workflow ontworpen en levert de infrastructuur die moderne productteams nodig hebben.
Lees meer over het bouwen van betrouwbare e-mailsystemen op https://sendhq.cc.