Op deze pagina
Als je een hostingbedrijf, SaaS-platform of managed e-mailprovider bent die transactionele e-mail beheert voor tientallen of honderden klantdomeinen, vergt een migratie van SendGrid naar AhaSend iets meer voorbereiding dan een enkelvoudige domeinwissel. Het goede nieuws: met de juiste DNS-architectuur op zijn plaats kun je elk klantdomein migreren binnen een onderhoudsvenster van 30 minuten, waarbij klanten na de initiële setup nooit meer iets aan hun DNS hoeven te wijzigen.
Deze gids behandelt het volledige proces, van voorbereiding tot live cutover.
Bijgewerkt in november 2026: AhaSend kan nu de DKIM-selectors hergebruiken die je klanten al hebben, ook de paren s1/s2 en os1/os2 van SendGrid, en je kunt elke klant een eigen sub-account geven.
Deze gids gaat over de DNS-kant. Voor de API-velden, SMTP-instellingen, webhooks en suppressies is er de migratiegids voor SendGrid in onze docs.
De architectuur: waarom een DNS-relaylaag het verschil maakt
Als je e-mail beheert voor veel klanten, is DNS-coördinatie het grootste migratierisico. Elke klant twee keer vragen hun DNS-records bij te werken, eenmaal voor de overstap naar AhaSend en mogelijk opnieuw als je later iets aan je infrastructuur verandert, leidt tot operationele rompslomp en support-overhead.
De aanpak die hier beschreven wordt, lost dat op door een DNS-relaylaag in te voeren op jouw platformdomein. Klanten wijzen hun DNS-records eenmalig naar jouw platformdomein (bijvoorbeeld customer.com → dkim1.customer.com.yourplatformdomain.com). Vanaf dat moment bepaal jij zelf waar die records naartoe wijzen. Je kunt de overstap van SendGrid naar AhaSend maken door je eigen DNS-records bij te werken, zonder dat klanten daar iets voor hoeven te doen.
Dit is een eenmalige investeringskost die toekomstige DNS-coördinatie met klanten permanent elimineert.
Wat je van tevoren verzamelt
Voordat je DNS of AhaSend-configuratie aanraakt, verzamel je het volgende per klantdomein vanuit je SendGrid-dashboard:
DKIM-configuratie: Noteer per domein welke DKIM-selector(s) in gebruik zijn en het volledige DKIM-subdomein. SendGrid gebruikt doorgaans s1/s2 of os1/os2 als selectors, met bijbehorende subdomeinen zoals s1._domainkey of os1._domainkey. Dit verschilt per klant, dus controleer elk domein afzonderlijk in het SendGrid-dashboard. Noteer van elk paar de eerste selector: die geef je in stap 3 aan AhaSend door.
Return-Path-subdomein: Noteer het Return-Path-subdomein dat momenteel in gebruik is. Dit ziet er vaak uit als em3560.customer.com. AhaSend ondersteunt nu het instellen van een aangepast Return-Path-subdomein, waardoor je het bestaande record van de klant kunt hergebruiken in plaats van een nieuw record aan te maken. Dit voorkomt zwevende DNS-records en houdt de DNS-zone van de klant overzichtelijk.
Trackingdomein: Noteer elk aangepast trackingdomein dat in gebruik is, bijvoorbeeld url7936.customer.com. Als een klant geen aangepast trackingdomein heeft ingesteld bij SendGrid, kun je AhaSend's standaard trackingconfiguratie gebruiken.
Stap 1: Stel de DNS-relaylaag in op jouw platformdomein
Maak voor elk klantdomein CNAME-records aan op jouw platformdomein (yourplatformdomain.com) die aanvankelijk wijzen naar de huidige SendGrid-bestemmingen. Dit zijn de tussenliggende records waar klanten naar verwijzen. Later laat je ze naar AhaSend wijzen.
Met customer.com als voorbeeldklantdomein:
| Record op yourplatformdomain.com | Type | Wijst aanvankelijk naar | Na migratie naar |
|---|---|---|---|
| dkim1.customer.com.yourplatformdomain.com | CNAME | s1.domainkey.<customerid>.wl035.sendgrid.net | uniqueidentifier.setup.ahasend.com |
| dkim2.customer.com.yourplatformdomain.com | CNAME | s2.domainkey.<customerid>.wl035.sendgrid.net | uniqueidentifier.setup.ahasend.com |
| track.customer.com.yourplatformdomain.com | CNAME | sendgrid.net | track.ahasend.com |
| prsp.customer.com.yourplatformdomain.com | CNAME | em<customerid>.wl035.sendgrid.net. | rp.ahasend.com |
Stap 2: Vraag elke klant hun DNS-records bij te werken (eenmalig, voorgoed)
Elke klant moet zijn DNS-records eenmalig bijwerken om naar jouw platformdomein te wijzen in plaats van rechtstreeks naar SendGrid. Dit is de enige DNS-wijziging die klanten ooit hoeven te maken.
Met customer.com als voorbeeld:
| Record | Type | Bijwerken naar |
|---|---|---|
| s1._domainkey.customer.com | CNAME | dkim1.customer.com.yourplatformdomain.com |
| s2._domainkey.customer.com | CNAME | dkim2.customer.com.yourplatformdomain.com |
| url<customerid>.customer.com | CNAME | track.customer.com.yourplatformdomain.com |
| em<customerid>.customer.com | CNAME | prsp.customer.com.yourplatformdomain.com |
Let op: als er geen trackingrecord bestaat en tracking vereist is, gebruik dan AhaSend's standaard: t.domain wijst naar track.customer.com.yourplatformdomain.com dat wijst naar track.ahasend.com.
Stap 3: Configureer AhaSend om overeen te komen met de bestaande SendGrid-instellingen
Hier maakt AhaSend's ondersteuning voor aangepaste subdomeinen de migratie soepel. In plaats van nieuwe standaard subdomeinen toe te wijzen die nieuwe DNS-records zouden vereisen, configureer je AhaSend zodat het exact overeenkomt met wat al aanwezig is bij SendGrid.
Voor elk klantdomein in het AhaSend-dashboard, onder Domeininstellingen of via de Management API:
DKIM: Stel als DKIM-selector van het domein de eerste selector in die de klant al gebruikt, bijvoorbeeld s1. Domeinen met managed DNS hebben bij AhaSend twee DKIM-selectors, zodat we sleutels kunnen wisselen zonder dat er opnieuw iets in DNS hoeft te veranderen. De tweede selector volgt uit de eerste: eindigt jouw selector op een 1, dan eindigt de tweede op een 2. s1 geeft dus s2 en os1 geeft os2, precies de paren die SendGrid gebruikt. De relay-records uit stap 1 werken daardoor na de cutover zonder aanpassing.
Je kunt het domein al aanmaken terwijl de DKIM-records van de klant nog naar SendGrid wijzen: AhaSend weigert een selector niet meer als er al DNS-records voor bestaan. DKIM slaagt zodra de relay-records wijzen naar de records die je van AhaSend krijgt. De selector ligt vast zodra DKIM voor het domein is geverifieerd, dus stel hem vóór de cutover in. Een eigen DKIM-selector hoort bij DNS whitelabel, dat in het Max-abonnement zit.
Return-Path: Stel het Return-Path-subdomein in op het bestaande record van de klant (bijvoorbeeld em1234). AhaSend ondersteunt deze configuratie direct, wat betekent dat er geen nieuw DNS-record aangemaakt hoeft te worden. Het bestaande record dat de klant al heeft blijft werken: het loopt na de cutover simpelweg via de platformrelay naar AhaSend.
Tracking: Stel het tracking-subdomein in op het bestaande SendGrid-trackingdomein van de klant. Voor klanten zonder een aangepast trackingdomein bij SendGrid gebruik je AhaSend's standaard.
Het kernprincipe: omdat AhaSend volledige aanpassing van subdomeinen ondersteunt, kun je de bestaande SendGrid-configuratie exact spiegelen. Geen nieuwe records, geen klantcommunicatie nodig, geen zwevende DNS-vermeldingen.
Via de Management API stel je alle drie in met één verzoek, op het moment dat je het domein aanmaakt:
curl --request POST \
--url https://api.ahasend.com/v2/accounts/{account_id}/domains \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"domain": "customer.com",
"dkim_selector": "s1",
"return_path_subdomain": "em3560",
"tracking_subdomain": "url7936"
}'Eén sub-account per klant: wil je klanten volledig van elkaar scheiden, maak dan eerst voor elke klant een sub-account aan en voeg het domein daar toe. Een sub-account heeft eigen domeinen, API-sleutels, webhooks en gebruikers, en het volume wordt via jouw account gefactureerd. Ook sub-accounts en hun eerste API-sleutel kun je via de API aanmaken.
Stap 4: Verlaag de TTL van jouw platformdomein
Verlaag de TTL van de DNS-records van jouw platformdomein (yourplatformdomain.com) naar 300 seconden voordat je een klant overzet. Zo verspreidt de wijziging zich snel wanneer je de relay-records bijwerkt om naar AhaSend te wijzen.
Doe dit ruim van tevoren, minimaal een paar uur voor het geplande onderhoudsvenster, zodat bestaande gecachte records verlopen.
Ga niet door naar stap 5 voordat de DNS-wijzigingen uit stap 1 en 2 zijn doorgevoerd en overal zichtbaar zijn.
Stap 5: Zet elk klantdomein over
Wanneer een klant klaar is om te migreren:
Bevestig dat de TTL van het platformdomein op 300 seconden staat.
Plan een onderhoudsvenster van 30 minuten. Tijdens dit venster:
Werk de relay-records op jouw platformdomein bij om naar AhaSend te wijzen in plaats van SendGrid. Voor customer.com betekent dit het bijwerken van:
dkim1.customer.com.yourplatformdomain.com→uniqueidentifier.setup.ahasend.comdkim2.customer.com.yourplatformdomain.com→uniqueidentifier.setup.ahasend.comtrack.customer.com.yourplatformdomain.com→track.ahasend.comprsp.customer.com.yourplatformdomain.com→rp.ahasend.com
Start de domeinverificatie in AhaSend, met Check DNS in het dashboard of via het Check DNS-endpoint, en wacht op bevestiging.
Verstuur een testmail en verifieer de aflevering.
Sluit het onderhoudsvenster.
De DNS-records van de klant zijn niet gewijzigd. Alleen de relay-records op jouw platformdomein zijn bijgewerkt, en die heb je volledig zelf in de hand.
Vanaf nu wisselt AhaSend de DKIM-sleutels van het domein zelf. Beide selectors lopen al via jouw relay, dus daarvoor hoeft niemand nog iets in DNS te wijzigen.
Waarom deze aanpak werkt op schaal
Voor een hostingbedrijf of SaaS-platform dat tientallen of honderden klantdomeinen beheert, heeft deze architectuur een aantal praktische voordelen.
Klantcoördinatie is een eenmalige kost. Na de initiële DNS-update vereisen toekomstige migraties, naar een andere AhaSend-configuratie of een andere provider, geen betrokkenheid van klanten.
Het hergebruiken van bestaande DNS-records voorkomt zwevende of verweesde records in de DNS-zones van klanten. Door het Return-Path-subdomein en DKIM-subdomeinen te hergebruiken in plaats van nieuwe aan te maken, blijft de DNS-zone van de klant overzichtelijk en eenvoudig te controleren.
Onderhoudsvensters zijn kort en voorspelbaar. Omdat alle infrastructuurwerkzaamheden vooraf plaatsvinden, bestaat de feitelijke cutover uit een DNS-update en een verificatiecontrole.
De configuratie in AhaSend kun je scripten met de Management API, de CLI of de SDK's voor Go en TypeScript. Zo bereid je tientallen domeinen tegelijk voor, nog voordat het eerste onderhoudsvenster begint.
Begin gratis met AhaSend
AhaSend is een Europese e-maildienst voor platformpartners en ontwikkelaars. De Management API en AVG-conforme infrastructuur zitten in elk abonnement. Sub-accounts zitten in Pro en Max, en eigen DKIM-selectors horen bij DNS whitelabel in Max.