Page mise à jour le
Ce que l'API permet
Ce que Mailchimp expose réellement
Repris de la documentation publique de l'éditeur, pas d'une plaquette commerciale. Le lien vers cette documentation est en bas de page.
Audiences, contacts, tags, segments
On crée une audience, on y ajoute des contacts, on les organise par tags, on les segmente selon l'activité. C'est le cœur de Mailchimp, et c'est ce que l'API fait le plus souvent. Un contact s'identifie par son e-mail. Le recoller depuis un CRM sans tenir compte d'une désinscription déjà enregistrée est la faute la plus coûteuse : elle se paie en plaintes, pas en 429. Les événements d'activité hors Mailchimp (achat, visite) peuvent être poussés pour qualifier sans ouvrir la campagne à tout le monde.
Lire l'activité, et être notifié
Les webhooks transmettent en temps presque réel ce qui arrive à l'audience : inscription, désinscription, changement d'e-mail. C'est la source à écouter pour mettre à jour le CRM, pas un export hebdomadaire oublié. L'API peut aussi servir de source de chiffres pour un tableau interne. Les valeurs qui ne changent pas doivent être mises en cache : Mailchimp le dit, parce que relire les mêmes statistiques vide le plafond de connexions.
Raccrocher une boutique aux campagnes
Les fonctions e-commerce de l'API Marketing permettent de lier commandes et produits à l'audience, pour des campagnes plus précises. Utile si vous vendez vraiment par e-mail. Inutile, et même bruyant, si Mailchimp ne sert qu'à une newsletter trimestrielle. Cette synchro se dimensionne : un catalogue entier poussé à chaque modification de prix n'est pas un usage raisonnable des lots asynchrones que Mailchimp propose précisément pour les gros volumes.
Lots asynchrones pour les gros volumes
Quand il y a trop à écrire d'un coup, Mailchimp documente un envoi par lots, pour ne pas saturer les limites. Ce n'est pas instantané : on dépose, on attend, on lit le résultat. Un import de plusieurs milliers de contacts passe par là, pas par une boucle d'appels individuels. Les lots n'autorisent pas à ignorer le consentement. Ils autorisent à ne pas se faire couper au milieu.
Documentation Mailchimp Marketing API — fondamentaux (nouvel onglet) — API Marketing 3.0 : audiences, forfait, authentification, dix connexions, délai de 120 s. Consultée le 21-08-2026.
Trois automatisations concrètes
Ce qu'on met en place avec
Trois situations réelles, décrites comme du travail plutôt que comme de la technique.
Inscrire le nouveau client, une seule fois
Un premier achat ou un opt-in explicite ajoute le contact à l'audience prévue, avec les tags de source. S'il existe déjà, on met à jour, on ne duplique pas. S'il s'est désinscrit, on n'écrit pas. L'agent ne « réabonne » jamais tout seul. Le commercial qui veut « le remettre dans la liste » le fait à la main, en connaissance de cause. C'est la seule façon de rester honnête avec le bouton de désinscription.
Retirer tout de suite une désinscription
Le webhook de désinscription met à jour le CRM et coupe les relances marketing. Il ne coupe pas un e-mail transactionnel de facture, qui n'appartient pas à Mailchimp. Confondre les deux, c'est soit continuer d'écrire à quelqu'un qui a dit non, soit cesser d'envoyer des pièces comptables. La frontière se dessine au cadrage, pas dans l'urgence d'une plainte.
Qualifier sans rouvrir la campagne
Un achat, un devis signé, un événement métier : l'agent pose un tag ou un événement sur le contact. La prochaine campagne pourra viser « clients 2026 » sans que personne n'exporte un CSV. Un tag posé trop large (« tous ») ne sert à rien. Un tag jamais lu non plus. On n'en crée que ceux qu'une campagne réelle utilisera dans les trente jours.
Limites
Ce que cette intégration ne fera pas
Les contraintes qu'on rencontre pour de vrai. Les découvrir maintenant coûte une lecture ; les découvrir en cours de projet coûte le projet.
Ce que l'API autorise dépend du forfait
Mailchimp l'écrit en tête de sa documentation : un compte est requis, et ce qu'on peut faire dépend du niveau d'abonnement. Certaines audiences, certains volumes, certaines fonctions e-commerce ne sont pas sur le forfait le plus bas. On le vérifie sur le compte réel avant de promettre une synchro boutique. Découvrir en cours de projet qu'il faut monter d'offre est exactement le coût que ces pages existent pour éviter.
Dix connexions à la fois, cent vingt secondes max
Au-delà de dix connexions simultanées, réponse 429. Au-delà de cent vingt secondes de calcul, l'appel est coupé. Mailchimp conseille de ne demander que les champs utiles et de paginer. Les appels trop lourds partent en lots. Il n'existe pas, d'après cette documentation, d'option pour lever ces plafonds au cas par cas. Une intégration qui relit toute l'audience toutes les minutes n'est pas « un peu lente », elle est hors contrat d'usage.
La clé meurt avec l'utilisateur
L'authentification est liée à l'utilisateur qui a créé la clé ou autorisé l'application. S'il quitte le compte, la clé est révoquée. Les droits suivent aussi son rôle : un utilisateur non admin se verra refuser certaines actions (403). Mailchimp recommande un utilisateur admin pour une intégration durable. Un départ de salarié non préparé coupe l'automatisation sans que le code ait changé. On prévoit le compte de service, on ne s'appuie pas sur la boîte personnelle du stagiaire.
Ce que brancher Mailchimp demande vraiment
Identifier le centre de données du compte (le suffixe de la clé), créer une clé sur un utilisateur admin stable, brancher un seul flux : opt-in vers l'audience, ou désinscription vers le CRM. Les campagnes restent rédigées et envoyées dans Mailchimp, sous vos yeux. On n'automatise pas l'envoi d'une newsletter. On automatise le fait que la liste soit juste au moment où vous appuyez sur le bouton.
Vos questions
Mailchimp peut-il remplacer un CRM ?
Non, pas honnêtement. Une audience est une liste de gens à qui l'on écrit, avec des tags et de l'activité d'e-mail. Ce n'est pas un pipeline, pas un historique d'affaires, pas un dossier de facturation. S'en servir comme fichier client unique finit par un mélange d'inscrits, de clients, de désinscrits et de doublons. L'intégration utile pousse vers Mailchimp ceux qui ont consenti, et ramène vers le CRM le signal « s'est désinscrit » ou « a cliqué ». Chacun reste à sa place.
Peut-on réinscrire quelqu'un qui s'est désabonné ?
Pas automatiquement, et ce n'est pas un oubli de l'API, c'est la règle du consentement. L'agent ne force pas un réabonnement. Si la personne s'inscrit à nouveau, par un formulaire, Mailchimp l'accepte. Si un commercial « a eu l'accord au téléphone », cet accord doit être tracé ailleurs, et le geste reste humain. Une automatisation qui réabonne pour « garder la liste propre » fait l'inverse : elle la rend indéfendable.
Pourquoi mes appels passent-ils parfois en 429 ?
Parce que dix connexions tournent déjà, ou que le volume d'appels est trop concentré. Mailchimp ne propose pas, dans cette documentation, de lever le plafond pour un client. La parade est de mettre en cache ce qui ne change pas, de paginer, et de passer les gros écritures en lots. Relancer immédiatement après un 429 aggrave le problème. On attend, on réduit le parallèle, on recommence. C'est aussi simple, et aussi peu négociable, que ça.
Une idée en tête ?
Réservez un rendez-vous ou écrivez-nous — réponse sous 24 h.