KoppelingenMailchimp
Mailchimp koppelen aan je website.
Met een koppeling op de Mailchimp API komen inschrijvingen uit je eigen formulier direct in de juiste audience, met tags, velden en groepen erbij. Wij sturen ze vanaf de server door, met een dubbele bevestiging waar die hoort, en laten afmeldingen terugkomen in je eigen systeem.
Vertrouwd door
200+ bedrijven en webshops
Wat het oplevert
Wat een koppeling met Mailchimp je oplevert.
Je eigen formulier. In je eigen ontwerp en zonder ingesloten script van Mailchimp, en toch direct in je audience.
De juiste tag en velden meteen. Een inschrijving krijgt de tag en de bron die bij die pagina horen, zodat je er een segment of automation op kunt bouwen.
Afmeldingen terug. Meldt iemand zich af in Mailchimp, dan weet je CRM of website dat ook, via de webhook.
Technisch
De koppeling in het kort.
- Vorm van de koppeling
- De Marketing API, versie 3.0 (REST), met audiences, leden, velden, groepen en tags, en webhooks per audience
- Authenticatie
- Een API-sleutel uit je eigen profiel, mee via basic auth; OAuth voor apps die namens anderen werken. Nieuwe sleutels verlopen na een jaar
- Richting
- Beide kanten op
- Verversing
- Per inschrijving, met maximaal 10 gelijktijdige verbindingen per gebruiker; afmeldingen realtime via de webhook
- Wij bouwen het op
- WordPress, Next.js, Maatwerk
Waar het misgaat
- Nieuwe API-sleutels verlopen na een jaar. Elke Mailchimp API key die je sinds 22 juni 2026 aanmaakt, verloopt een jaar na de aanmaakdatum. Oudere sleutels blijven werken. Een koppeling die vandaag live gaat, stopt dus over twaalf maanden zonder waarschuwing op de site, en inschrijvingen gaan dan verloren. Wij zetten de vervaldatum in de agenda van de klant en laten mislukte aanroepen een melding geven. De volledige sleutel zie je bovendien maar één keer, direct na het aanmaken.
- De opt-in-instelling van je audience geldt niet voor de API. Dubbele bevestiging stel je in Mailchimp in voor de eigen aanmeldformulieren van Mailchimp. Komt een inschrijving via de API, dan bepaalt de status die je meestuurt wat er gebeurt: met subscribed staat iemand direct ingeschreven zonder bevestigingsmail, met pending stuurt Mailchimp eerst de bevestiging. Wie een audience met dubbele bevestiging heeft en via de API subscribed stuurt, slaat die stap ongemerkt over.
- Wie zich zelf afmeldt, zet je niet terug via je eigen formulier. Volgens Mailchimp moet iemand die zich zelf heeft afgemeld zich opnieuw aanmelden via het aanmeldformulier van Mailchimp. Schrijft zo iemand zich later in via jouw formulier, dan wordt hij niet automatisch weer ingeschreven. Wij vangen dat af met een nette melding en een link naar het Mailchimp-formulier, in plaats van een foutmelding of een stille mislukking.
- 10 verbindingen tegelijk, per gebruiker. De Marketing API staat 10 gelijktijdige verbindingen toe, en die grens geldt per gebruiker, niet per sleutel. Daarboven volgt een 429, en een aanroep die langer dan 120 seconden duurt, wordt afgebroken. Voor een formulier is dat ruim. Voor een import van een bestaand bestand gebruiken we batch-opdrachten, want herhaald overschrijden kan je API-toegang laten uitschakelen.
Mailchimp koppelen
Wat je moet weten voor je begint.
Wat is Mailchimp?
Mailchimp is software voor e-mailmarketing. Je contacten staan in een audience, een lijst met velden, groepen en tags, en vanuit die audience verstuur je nieuwsbrieven en automatische reeksen.
Naast de nieuwsbriefkant is er Mailchimp Transactional, voorheen Mandrill. Dat is een aparte dienst voor losse berichten zoals orderbevestigingen en wachtwoordherstel, met een eigen API-sleutel. Het is een betaalde uitbreiding die een Standard- of Premium-account vraagt. Wie zoekt op de Mailchimp API, komt beide tegen; voor een inschrijfformulier heb je alleen de Marketing API nodig.
Hoe de Mailchimp API werkt
De Marketing API is versie 3.0 en REST. Je maakt een API-sleutel aan in je profiel, onder Extras en dan API keys, en die gaat mee via basic auth. Wij zetten de sleutel op de server. Het formulier op je site stuurt naar je eigen server, en die praat met Mailchimp. Zo blijft de sleutel binnen en de opmaak van jou.
Een contact heeft een vast adres in de API, gebaseerd op een hash van het e-mailadres in kleine letters, omgezet met MD5. Met één aanroep op dat adres voeg je een nieuw contact toe of werk je een bestaand contact bij. Je geeft daarbij een status mee voor als het adres nieuw is, en een status voor als het al bestaat. Zo ontstaat er nooit een tweede versie van dezelfde persoon.
Wat je meestuurt: velden, groepen en tags
Het e-mailadres is het minste. In de merge fields, de velden van je audience, zet je naam, bedrijf of telefoonnummer. Een veld moet wel eerst in de audience bestaan, en verplichte velden moeten gevuld zijn, anders weigert Mailchimp de inschrijving.
Groepen zijn keuzes die de inschrijver zelf maakt, zoals de onderwerpen waarover hij mail wil krijgen. In de API heten ze interests en geef je ze mee als id met ja of nee. Tags zijn labels die jij toekent, zoals de pagina of campagne waar de inschrijving vandaan komt. Wij leggen per formulier vast welke tag erbij hoort, zodat er geen tag met een typfout ontstaat waar geen segment op reageert.
Dubbele bevestiging en toestemming
Een inschrijving is nog geen bewijs van toestemming. Voor commerciële e-mail moet je kunnen laten zien dat iemand zich heeft aangemeld, en een dubbele bevestiging (double opt-in) is daar de duidelijkste manier voor.
Via de API regel je dat met de status. Stuur je pending mee, dan krijgt de inschrijver een mail met een bevestigingslink en staat hij pas na die klik als ingeschreven. Stuur je subscribed, dan is hij direct ingeschreven. Wat juist is, is een juridische keuze en geen technische, en die maken we aan het begin samen.
Iemand die zich zelf afmeldt, kan alleen terugkomen via het aanmeldformulier van Mailchimp. Je eigen formulier vangt dat op met een melding en een link.
Afmeldingen terug met webhooks
Mailchimp kan per audience een webhook sturen naar een adres op je eigen server: bij een inschrijving, een afmelding, een gewijzigd profiel of e-mailadres, een adres dat is opgeschoond en een verzonden campagne. Per webhook kies je ook de bron: de inschrijver zelf, een beheerder in Mailchimp of de API.
De bruikbaarste is de afmelding. Meldt iemand zich af onder een nieuwsbrief, dan zet de webhook dat ook in je CRM of in de database van je site, zodat niemand hem daar per ongeluk weer aanschrijft. Wij zetten de bron api daarbij uit, zodat wijzigingen die de koppeling zelf doet niet in een rondje terugkomen.
Een webhook moet binnen 10 seconden antwoorden. Lukt dat niet, dan probeert Mailchimp het tot 75 minuten opnieuw, en een adres dat te vaak traag is, kan worden uitgeschakeld. Webhooks kunnen ondertekend zijn met een handtekening in de header X-Mailchimp-Signature, die we op de server controleren.
Mailchimp, ActiveCampaign of Klaviyo
Mailchimp is gebouwd rond nieuwsbrieven en een overzichtelijke audience. Wie meer leunt op automatisering met een verkooppijplijn eronder, komt eerder uit bij ActiveCampaign. Een webshop die mails wil sturen op basis van bestellingen en productgedrag kijkt vaak naar Klaviyo.
Voor de koppeling met je website maakt de keuze weinig uit: alle drie ontvangen een inschrijving met velden en tags vanaf je eigen server. Stap je over, dan nemen we de velden en tags mee, zodat segmenten blijven werken.
Mailchimp koppelen met WordPress of met maatwerk
Voor een WooCommerce-webshop is er Mailchimp for WooCommerce, de officiële plugin van Mailchimp met meer dan 200.000 actieve installaties. Die stuurt klanten en bestellingen naar je audience. Klanten die bij het afrekenen geen toestemming geven, komen erin als transactional contact en krijgen geen nieuwsbrief.
Voor formulieren op WordPress levert Mailchimp ingesloten formulieren, en er zijn plugins voor. Dat werkt, maar het komt met eigen opmaak, laadt een script van buiten en maakt het meten van een inschrijving lastiger. Wij bouwen het formulier in je eigen ontwerp en laten een kleine uitbreiding op de server de aanroep doen.
Op een maatwerksite in Next.js is het een serverroute die de inschrijving verwerkt en een tweede route voor de webhook. Formulieren en koppelingen als deze vallen bij ons onder Design & Development.
Bijgewerkt op
Specialist voor koppelingen
JosDesign & Development085 83 30 533jos@klubb.nlVeelgestelde vragen
Heeft Mailchimp een API?
Ja. Mailchimp heeft de Marketing API, versie 3.0, waarmee je website contacten toevoegt en bijwerkt in een audience, inclusief velden, groepen en tags. Daarnaast is er een aparte API voor Mailchimp Transactional, voorheen Mandrill, voor losse berichten zoals orderbevestigingen. Voor een inschrijfformulier op je website gebruik je de Marketing API.
Hoe kom ik aan een Mailchimp API key?
Een Mailchimp API key maak je aan in je eigen profiel: klik op je profielicoon, kies Profile, open Extras en kies API keys. Daar maak je een nieuwe sleutel aan. Je ziet de volledige sleutel maar één keer, direct na het aanmaken, dus bewaar hem meteen op een veilige plek, en in een koppeling alleen op de server.
Verloopt een Mailchimp API key?
Ja, als hij is aangemaakt op of na 22 juni 2026. Zulke sleutels verlopen een jaar na de aanmaakdatum; oudere sleutels blijven werken. Een koppeling stopt dan zonder zichtbare melding op je site. Wij noteren de vervaldatum en laten mislukte aanroepen een melding geven, zodat je op tijd een nieuwe sleutel kunt zetten.
Kan mijn eigen formulier in Mailchimp landen?
Ja. Het formulier staat in je eigen ontwerp en stuurt naar je eigen server, die de inschrijving via de Mailchimp API in de juiste audience zet, met tag en velden. Zo blijft de sleutel binnen, laadt er geen extern script en kun je de inschrijving als conversie meten op je eigen pagina.
Hoe werkt dubbele bevestiging via de Mailchimp API?
Dubbele bevestiging regel je via de status die je meestuurt. Met pending krijgt de inschrijver eerst een bevestigingsmail en staat hij pas na de klik als ingeschreven. Met subscribed is hij direct ingeschreven, zonder bevestiging. De opt-in-instelling van je audience geldt alleen voor de formulieren van Mailchimp zelf, niet voor de API.
Komen tags en groepen mee naar Mailchimp?
Ja. Bij het toevoegen of bijwerken van een contact geef je tags mee als lijst en groepen als id met ja of nee. Velden zoals naam of bedrijf gaan mee als merge fields. Het veld en de groep moeten wel eerst in je audience bestaan. Wij leggen per formulier vast welke tag erbij hoort.
Werkt een Mailchimp-koppeling op WordPress?
Ja. Er zijn ingesloten formulieren en plugins, maar wij bouwen het formulier liever in je eigen opmaak en laten de aanroep vanaf de server lopen. Dat voorkomt een extra script en eigen vormgeving van Mailchimp, en het maakt de inschrijving meetbaar als conversie op je eigen site.
Hoe koppel ik Mailchimp aan WooCommerce?
Mailchimp koppel je aan WooCommerce met Mailchimp for WooCommerce, de officiële plugin van Mailchimp. Die stuurt klanten en bestellingen naar je audience. Wie bij het afrekenen geen toestemming geeft, komt erin als transactional contact en krijgt geen nieuwsbrief. De plugin heeft WP_CRON nodig om te synchroniseren, dus controleer dat bij je hosting.
Kan Mailchimp afmeldingen terugsturen naar mijn website of CRM?
Ja, met een webhook per audience. Mailchimp stuurt dan bij een afmelding, inschrijving of profielwijziging een bericht naar een adres op je eigen server. Wij verwerken dat daar, bijvoorbeeld door het contact in je CRM als afgemeld te markeren. Je server moet binnen 10 seconden antwoorden, anders volgt een nieuwe poging.
Wat is het verschil tussen Mailchimp en Mailchimp Transactional?
Mailchimp is voor nieuwsbrieven en automatische reeksen naar je audience. Mailchimp Transactional, voorheen Mandrill, is een aparte dienst voor losse berichten aan één persoon, zoals een orderbevestiging of wachtwoordherstel. Het heeft een eigen API-sleutel, is een betaalde uitbreiding en vraagt een Standard- of Premium-account.
Hoeveel aanvragen mag een Mailchimp-koppeling doen?
De Marketing API staat 10 gelijktijdige verbindingen per gebruiker toe, ongeacht hoeveel sleutels je hebt. Daarboven volgt een 429, en een aanroep stopt na 120 seconden. Voor een formulier is dat ruim. Bij een grote import gebruiken we batch-opdrachten, omdat herhaald overschrijden je API-toegang kan laten uitschakelen.
Let's work together.
Je inschrijvingen in Mailchimp, met de juiste tag en een bevestiging die klopt.