HubSpot Klaviyo : quelle intégration existe vraiment ?
La question arrive presque toujours dans le même contexte. Une marque DTC a un CRM HubSpot installé côté commercial ou support, elle veut passer son email e-commerce sur Klaviyo, et quelqu'un demande si "les deux se branchent ensemble". La réponse honnête tient en une distinction : il existe des façons de faire circuler des données entre HubSpot et Klaviyo, mais la documentation officielle Klaviyo ne décrit pas d'intégration native pré-construite avec HubSpot.
Cet article fait le tri entre ce qui est documenté, ce qui relève du sur-mesure, et ce que personne ne peut vous promettre sans l'avoir vérifié dans votre compte. Objectif : que vous sachiez quoi demander à votre prestataire ou à votre dev avant de signer quoi que ce soit.
Ce que dit la documentation Klaviyo sur HubSpot
Klaviyo publie une page listant les intégrations qu'elle construit et maintient elle-même. HubSpot n'y figure pas. La page conclut en renvoyant les utilisateurs vers l'app marketplace pour tout ce qui n'est pas couvert : "Looking to integrate other platforms or tools with Klaviyo? Check out our app marketplace, which includes integrations and apps built by both Klaviyo and third parties" (Klaviyo Help Center).
Le seul parcours HubSpot réellement documenté par le centre d'aide Klaviyo est une migration par export CSV, pas une synchronisation bidirectionnelle. Le guide indique de choisir le CSV comme format d'export depuis HubSpot et de sélectionner toutes les propriétés des enregistrements : "Choose CSV as the file format, and select All properties on records" (Klaviyo Help Center).
Des connecteurs tiers existent sur le marché (app marketplace, outils d'automatisation type iPaaS). Leur périmètre de synchronisation, leur éditeur et leur tarif ne sont pas documentés sur les pages Klaviyo consultables : si un prestataire vous en recommande un, demandez la fiche produit, la fréquence de synchronisation réelle et le détail des objets synchronisés par écrit avant de vous engager.
Autre contrainte structurelle à avoir en tête quand on empile les outils : un compte Klaviyo ne supporte qu'une seule intégration par type (Klaviyo Help Center). Cela pèse sur les architectures multi-boutiques ou multi-CRM, et c'est souvent le point qui fait basculer une archi vers du sur-mesure API.
Les trois scénarios possibles, et lequel vous concerne
Avant d'ouvrir un chantier technique, tranchez le besoin. Dans nos audits, 80 % des demandes "intégration HubSpot Klaviyo" relèvent en fait du scénario 1.
Scénario 1 : vous migrez de HubSpot vers Klaviyo
Vous quittez HubSpot pour l'email marketing. Il n'y a pas de synchronisation à construire : c'est un transfert ponctuel de base, suivi d'une bascule des envois. C'est le scénario documenté par Klaviyo, et de loin le plus simple à sécuriser. On détaille le parcours complet dans notre guide de migration HubSpot vers Klaviyo.
Scénario 2 : vous gardez HubSpot pour le commercial, Klaviyo pour l'e-commerce
Deux outils, deux usages, deux bases qui doivent rester cohérentes. C'est le cas des marques avec une activité B2B ou wholesale à côté du DTC. Là, une circulation de données est nécessaire, et elle passe soit par un connecteur tiers, soit par l'API Klaviyo. C'est aussi le moment de clarifier qui est la source de vérité sur le consentement et sur les propriétés client, sujet qu'on traite dans structurer un funnel email CRM B2B.
Scénario 3 : vous voulez déclencher des actions HubSpot depuis Klaviyo
Un flow Klaviyo qui notifie un commercial, crée une tâche, met à jour une fiche. Là, le mécanisme adapté est le webhook Klaviyo, qui est sortant : "Webhooks allow Klaviyo to pass information or 'call' other applications, tools, and servers via HTTP requests" (Klaviyo Help Center).
Un webhook placé dans un flow envoie une requête POST avec les données de l'événement ou du destinataire déclencheur (Klaviyo Help Center). Deux prérequis à connaître avant de promettre ça à une équipe commerciale :
- l'authentification à deux facteurs doit être activée sur le compte, et l'usage des webhooks est réservé aux rôles Manager, Admin et Owner (même source) ;
- les webhooks d'Advanced KDP font l'objet d'un abonnement séparé de l'application marketing standard (Klaviyo Help Center).
Le comportement de réessai et le timeout d'un webhook de flow en cas d'échec côté destinataire ne sont pas spécifiés sur la page publique. Si votre process commercial dépend de la réception de ce POST, prévoyez une file d'attente et un log côté récepteur plutôt que de compter sur un retry implicite, et faites confirmer le comportement par le support Klaviyo.
La voie CSV : le parcours documenté, étape par étape
C'est le chemin officiel, et il est plus piégeux qu'il n'en a l'air. Voici l'ordre d'opérations que nous appliquons.
1. Mettre les flows en pause avant tout import
C'est l'étape que tout le monde saute, et c'est celle qui coûte le plus cher. La doc Klaviyo est explicite : certains flows sont déclenchés par l'ajout d'une adresse à une liste, il faut donc les passer en brouillon ou en mode manuel avant de commencer l'upload (Klaviyo Help Center).
Traduction terrain : si votre welcome flow tourne pendant l'import de 30 000 contacts HubSpot, vous envoyez un email de bienvenue à des gens qui vous connaissent depuis trois ans. Sur la délivrabilité, c'est le scénario le plus violent qui soit. Voir aussi les 5 erreurs Klaviyo les plus fréquentes en audit.
2. Préparer le fichier au bon format
Contraintes documentées :
| Élément | Règle | Source |
|---|---|---|
| En-tête première colonne | Email ou Email Address |
Klaviyo |
| Ligne des en-têtes | Première ligne du fichier | Klaviyo |
| Taille du fichier | 50 Mo maximum, sinon découper | Klaviyo |
| Statuts de consentement reconnus | Subscribed, Unsubscribed, Never subscribed | Klaviyo |
Klaviyo affiche une limite en mégaoctets, pas en nombre de lignes. Dimensionnez donc vos lots sur le poids du fichier, pas sur un nombre de contacts supposé.
Le mapping des propriétés HubSpot vers les propriétés Klaviyo (lifecycle stage, appartenance aux listes, soumissions de formulaires) n'est pas couvert par une table de correspondance officielle. C'est du travail manuel, à faire colonne par colonne, avec une convention de nommage décidée en amont. Notre méthode de structuration est dans Klaviyo custom properties : guide de segmentation.
3. Traiter les désabonnés à part
Point critique et souvent raté. Les désabonnés et les bounces ne s'importent pas dans une liste : ils vont dans les profils supprimés, via un CSV d'une seule colonne contenant une adresse par ligne (Klaviyo Help Center).
Si vous importez les désabonnés HubSpot comme des contacts normaux, vous ré-abonnez des gens qui vous ont explicitement demandé d'arrêter. Faites ce second import avant de réactiver le moindre envoi.
4. Cocher le consentement en connaissance de cause
À l'import, cocher "Subscribe to Email Marketing" vaut déclaration de consentement explicite pour tous les profils du fichier : "Click Subscribe to Email Marketing in the Email row to denote that all profiles in this upload have explicitly consented" (Klaviyo Help Center).
C'est une case produit, pas un blanc-seing juridique. La documentation Klaviyo décrit la mécanique, pas la validité du consentement transféré au regard du RGPD. Avant de cocher, vérifiez l'origine réelle de chaque segment HubSpot (formulaire opt-in, import commercial, base achetée) et alignez-vous avec votre DPO ou votre conseil. Nos repères pratiques sont dans RGPD email marketing 2026 : checklist conformité.
5. Ne pas envoyer à toute la base le premier jour
Klaviyo recommande, en migration depuis un autre outil, de restreindre les premiers envois à un segment engagé : une semaine si vous envoyez quotidiennement, 2 à 3 campagnes si vous envoyez plus d'une fois par semaine (Klaviyo Help Center).
Une base HubSpot contient souvent des contacts commerciaux jamais sollicités par email marketing. Les envoyer en masse depuis un domaine expéditeur qui n'a pas encore d'historique sur cette audience, c'est fabriquer des plaintes. Le protocole complet est dans réchauffer une IP dédiée : le vrai calendrier.
La voie API : quand le CSV ne suffit plus
Si vous êtes sur le scénario 2 (les deux outils cohabitent durablement), le CSV devient ingérable. On passe alors par l'API Klaviyo. Klaviyo documente d'ailleurs un guide dédié à l'intégration d'une plateforme sans connecteur pré-construit.
Authentification et conception
Les endpoints /api s'authentifient par clé privée avec scopes, et Klaviyo recommande OAuth aux partenaires techniques (Klaviyo Developers).
Ce choix n'est pas cosmétique. Une application OAuth dispose de son propre quota de rate limit par instance installée, alors que les intégrations par clé privée partagent le même quota au niveau du compte (Klaviyo Developers). Autrement dit : si votre connecteur HubSpot tape en clé privée, il consomme le même budget de requêtes que vos autres outils branchés sur le compte, et un batch de synchronisation peut dégrader le reste de la stack.
Volumes et limites
- L'endpoint d'import en masse de profils accepte jusqu'à 10 000 profils par requête (Klaviyo Developers).
- L'API applique deux fenêtres de limitation, une rafale sur 1 seconde et une fenêtre stable sur 1 minute, et renvoie un HTTP 429 en cas de dépassement (Klaviyo Developers).
- Un réessai après 429 doit attendre la durée indiquée par l'en-tête
Retry-After(même source).
Un connecteur maison qui ignore Retry-After et rejoue en boucle finit par se faire limiter en permanence. C'est le bug le plus fréquent sur les scripts de synchronisation écrits à la va-vite.
Événements : côté serveur, pas côté client
Pour une intégration sur mesure, Klaviyo recommande l'API serveur pour les métriques critiques ou contenant des données sensibles plutôt que le JavaScript côté client : "For more crucial metrics (e.g., transactional events and properties) or ones that may contain sensitive data, use our server-side Track API" (Klaviyo Developers). Le détail de mise en œuvre est couvert dans API Klaviyo : envoyer des events depuis votre stack.
Côté fréquence de synchronisation et profondeur de backfill historique lors d'une première connexion, aucun chiffre n'est publié sur les pages Klaviyo consultées. Ce sont deux questions à poser explicitement à l'éditeur du connecteur que vous envisagez, ou à spécifier vous-même si vous développez l'intégration.
Les questions à poser avant de lancer le chantier
Une checklist courte, à passer en revue avec votre équipe technique :
- Quelle est la source de vérité du consentement ? Un seul outil doit trancher. Sinon vous aurez un désabonné côté Klaviyo qui reste actif côté HubSpot, et l'inverse.
- Quels objets circulent, et dans quel sens ? Contacts seuls, ou contacts plus événements, plus propriétés calculées ? Écrivez-le avant de choisir l'outil.
- Que se passe-t-il en cas d'échec de synchronisation ? Log, alerte, rejeu manuel : décidez-le au moment de la conception, pas après le premier incident.
- Qui possède les clés API et les scopes ? Une clé privée avec un scope trop large qui traîne dans un outil no-code, c'est une dette de sécurité.
- Combien de contacts vraiment actifs allez-vous transférer ? Une base HubSpot gonflée de contacts commerciaux inertes coûte cher sur Klaviyo et abîme la délivrabilité. Nettoyez avant, pas après : list hygiene Klaviyo.
Si vous démarrez de zéro sur Klaviyo dans la foulée, la checklist de setup Klaviyo Shopify en 14 étapes reprend l'ordre d'installation à respecter. Et si vous voulez déléguer la bascule, c'est exactement le genre de chantier que prend en charge notre agence Klaviyo.
Ce qu'il faut retenir
La page officielle des intégrations construites par Klaviyo ne liste pas HubSpot, et le seul parcours HubSpot documenté par le centre d'aide est un export CSV. Tout le reste (connecteur tiers, synchronisation bidirectionnelle, temps réel) relève d'un choix d'architecture qui doit être vérifié dans votre contexte, avec des engagements écrits de l'éditeur concerné.
Pour la majorité des marques DTC, le bon arbitrage est simple : migrer proprement en CSV, garder HubSpot pour ce qu'il fait bien côté commercial, et ne construire une synchronisation API que si un process métier réel en dépend. Construire un connecteur temps réel pour synchroniser des contacts qu'on n'active jamais, c'est de la dette technique déguisée en modernité.
FAQ
Klaviyo propose-t-il une intégration native HubSpot ?
La page officielle des intégrations construites par Klaviyo ne mentionne pas HubSpot et renvoie vers l'app marketplace pour les outils non couverts (source). Le seul parcours HubSpot documenté par le centre d'aide est une migration par export CSV.
Comment importer mes contacts HubSpot dans Klaviyo ?
Exportez en CSV depuis HubSpot en sélectionnant toutes les propriétés, mettez en brouillon les flows déclenchés par l'ajout à la liste cible, vérifiez que la première colonne porte un en-tête Email ou Email Address, puis importez. Le fichier ne doit pas dépasser 50 Mo (source).
Que faire des désabonnés HubSpot ?
Ils ne s'importent pas dans une liste. Préparez un CSV d'une seule colonne, une adresse par ligne, et importez-le dans les profils supprimés de Klaviyo (source). Faites-le avant de reprendre les envois.
Peut-on synchroniser Klaviyo vers HubSpot en temps réel ?
Klaviyo permet d'appeler d'autres applications via des webhooks sortants depuis un flow, avec une requête POST contenant les données du déclencheur (source). L'entrée de données dans Klaviyo passe, elle, par l'API. La fréquence réelle d'un connecteur tiers n'est pas publiée : demandez-la à son éditeur.
Combien de profils puis-je pousser par requête API ?
L'endpoint d'import en masse accepte jusqu'à 10 000 profils par requête (source). Respectez les deux fenêtres de rate limit (rafale 1 seconde, stable 1 minute) et attendez la durée de l'en-tête Retry-After après un 429.
Provenance et vérification
Affirmations chiffrées et techniques comparées le 2026-09-11 aux pages officielles listées dans sources. Les points non tranchés par la documentation ont été écartés.
- Sources contrôlées le
- Relu par
- Claude (CLI local) contrôle croisé de la documentation éditeur
- Assistance IA
- Oui
- Sources
-
- help.klaviyo.com/hc/en-us/articles/360039708512
- help.klaviyo.com/hc/en-us/articles/115000256472
- help.klaviyo.com/hc/en-us/articles/115005081007
- developers.klaviyo.com/en/docs/guide-to-integrating-a-platform-without-a-pre-built-klaviyo-integration
- developers.klaviyo.com/en/docs/rate_limits_and_error_handling
- developers.klaviyo.com/en/reference/api_overview
- developers.klaviyo.com/en/reference/spawn_bulk_profile_import_job
- help.klaviyo.com/hc/en-us/articles/115005251128
- help.klaviyo.com/hc/en-us/articles/115005078487
- help.klaviyo.com/hc/en-us/articles/115005082767
- help.klaviyo.com/hc/en-us/articles/18622300908955
- help.klaviyo.com/hc/en-us/articles/4534329515931
Besoin d'appliquer ça à votre stack ?
30 minutes avec Charlotte. On audit votre setup CRM en direct, on chiffre l'opportunité, vous repartez avec un plan d'attaque.
Réserver 30 minutes →