Votre ERP connaît le statut de chaque commande. Votre outil de fidélité sait qui vient de passer VIP. Klaviyo, lui, ignore les deux.
L’API Klaviyo sert à combler ce vide. Klaviyo ne sert pas qu’à envoyer des e-mails : il centralise la donnée client, et son API permet de le brancher sur n’importe quel outil, même sans connecteur natif.
Standard Ecom est partenaire Klaviyo Master Elite, et nous branchons ce type d’intégrations au quotidien.
Ce guide s’adresse aux directeurs e-commerce, CTO et CEO qui veulent savoir ce que l’API rend possible, et ce qu’elle demande. Au programme : la définition, les types d’API, la configuration pas à pas, les données synchronisables, les cas d’usage, les bonnes pratiques et les erreurs à éviter.
Qu’est-ce que l’API Klaviyo et pourquoi est-elle centrale pour votre stack e-commerce ?
Une API (Application Programming Interface) permet à deux applications d’échanger des données automatiquement, sans que personne n’exporte un fichier ni ne ressaisisse une ligne.
L’API Klaviyo applique ce principe à votre écosystème. Elle relie la plateforme aux outils qui produisent déjà de la donnée client :
- votre CMS ou votre boutique en ligne
- votre CRM commercial
- votre ERP et votre gestion des stocks
- votre programme de fidélité
- votre solution de support client
- votre outil de business intelligence
Klaviyo ne peut segmenter et déclencher que sur ce qu’il reçoit. Une commande de l’ERP, un ticket clos par le support ou un palier de fidélité franchi lui arrivent en temps réel, au lieu de rester dans l’application qui les a produits
Klaviyo traite en moyenne 1,6 milliard d’appels d’API par jour (Klaviyo, 2026), un volume qui atteste de la robustesse de l’infrastructure sous vos intégrations.
Quels types d’API propose Klaviyo ?
Klaviyo propose deux familles d’API : les API serveur, appelées depuis vos systèmes avec une clé privée, et les API client, appelées depuis un navigateur ou une application mobile avec la clé publique. Les webhooks complètent le dispositif pour renvoyer des données de Klaviyo vers vos outils.
Les API serveur : lire, créer et manipuler vos données
Les API serveur suivent une architecture REST et échangent des données au format JSON.
Elles donnent accès à l’ensemble de votre compte, découpé en API spécialisées :
- Profiles : créer et mettre à jour les profils clients
- Events : envoyer les actions de vos clients (commande passée, abonnement démarré, produit consulté, ajout au panier)
- Lists et Segments : gérer vos listes et vos segments par programme
- Catalogs : synchroniser votre catalogue produits, indispensable pour les recommandations sur une boutique sans intégration native
- Campaigns et Flows : piloter vos envois
- Metrics et Reporting : extraire vos résultats
Pour les gros volumes, comme une première synchronisation ERP de plusieurs dizaines de milliers de profils, les imports en masse envoient les données par lots plutôt qu’un appel par profil.
Les API client : capturer les comportements sur le site et l’app
Les API client s’appellent directement depuis le navigateur ou une application mobile, avec la clé publique. Elles servent à enregistrer ce qui se passe côté visiteur : produit consulté, ajout au panier, inscription via un formulaire.
Sur les plateformes qui ont une intégration native (Shopify, WooCommerce, Magento 2, PrestaShop, BigCommerce), le script de suivi Klaviyo s’installe automatiquement. Notre guide de l’intégration Klaviyo et Shopify détaille ce parcours. Sur une boutique headless ou une plateforme maison, ce script et les appels côté client s’ajoutent à la main.
Les webhooks : renvoyer des données vers vos outils
La plupart des données circulent vers Klaviyo, mais les webhooks permettent aussi le chemin inverse. Placé dans un flow, un webhook prévient votre outil de fidélité qu’un client vient d’entrer dans un scénario VIP, ou demande à votre CRM commercial de créer une tâche.
Comment configurer l’API Klaviyo étape par étape ?
Clé publique vs clé privée : comprendre la différence
La clé publique sert aux API client, la clé privée aux API serveur.
La clé publique, que Klaviyo nomme aussi identifiant de site, est un identifiant court et unique par compte. Elle ne donne accès à aucune donnée sensible et peut figurer dans le code de votre site. Elle permet toutefois d’envoyer des inscriptions et des événements depuis le navigateur : protégez vos formulaires contre les fausses inscriptions, avec un double opt-in ou un captcha.
Les clés privées, elles, lisent des données et manipulent des objets sensibles, listes, profils et abonnements, au même niveau de confidentialité qu’un mot de passe.
Rien ne limite leur nombre. Créez-en une par intégration pour maintenir la traçabilité des données entrantes et pouvoir révoquer un accès sans impacter les autres. Seuls les propriétaires et les administrateurs du compte atteignent l’onglet des clés d’API.
Pour une application tierce ou un partenaire technique qui se connecte à plusieurs comptes, Klaviyo recommande OAuth plutôt qu’une clé privée.
Créer une clé API privée et exécuter un premier appel
Dans une interface Klaviyo en français, le chemin passe par le nom de votre organisation en bas à gauche, puis Paramètres, puis Clés d’API. Le bouton Créer une clé d’API privée ouvre la configuration, où vous nommez la clé (ERP Sync, BI Dashboard) et choisissez son niveau d’accès parmi :
- Lecture seule
- Complet
- Personnalisée
Choisissez Personnalisée et n’activez que les permissions utiles, en lecture ou en écriture, sur les profils, les événements ou les listes. Vous pouvez ensuite tester la clé en ligne de commande. Cet appel renvoie simplement les informations de votre compte. Pour ce test, la clé doit avoir la permission de lecture sur les comptes (Accounts) : sinon, Klaviyo renvoie une erreur 403.
curl –request GET \
–url https://a.klaviyo.com/api/accounts \
–header ‘Authorization: Klaviyo-API-Key votre-cle-privee’ \
–header ‘accept: application/vnd.api+json’ \
–header ‘revision: 2026-07-15’
💡 Tip Standard Ecom
Une clé privée ne s’affiche qu’au moment de sa création. Ouvrez votre gestionnaire de mots de passe avant de cliquer sur Créer, et enregistrez-la sous son nom Klaviyo exact.
Quelles données synchroniser via l’API Klaviyo ?
Quatre familles de données transitent par l’API, chacune avec son usage.
Les profils s’identifient par l’e-mail, le numéro de téléphone ou un identifiant externe (external_id), celui de votre ERP ou de votre CRM par exemple. Chaque profil porte ensuite le nom, l’adresse et toutes les propriétés personnalisées que vous ajoutez, d’une date de naissance à un score RFM calculé ailleurs.
Les événements racontent le comportement :
- commandes passées,
- produits consultés,
- paniers abandonnés,
- tickets de support,
- inscriptions à un événement.
Les listes et les segments se gèrent par programme, mais pas de la même façon. Dans une liste, vous ajoutez et retirez vous-même les profils. Un segment, lui, se remplit tout seul à partir de ses conditions : l’API permet de le créer et de le lire, pas d’y ajouter un profil à la main.
Les données de performance, enfin, s’extraient par la Reporting API : taille d’un segment, ajouts, ouvertures, clics et conversions (documentation de la Reporting API). La Klaviyo Academy propose un module dédié aux rapports personnalisés.
Attention au consentement : créer ou mettre à jour un profil via l’API ne l’abonne pas à vos e-mails ni à vos SMS. L’abonnement passe par un appel dédié, qui enregistre le consentement. Importer depuis l’ERP des clients qui n’ont jamais accepté vos communications marketing, puis leur écrire, vous expose au RGPD autant qu’à vos filtres anti-spam.
Quels sont les cas d’usage concrets de l’API Klaviyo pour le e-commerce ?
Déclencher des scénarios à partir d’événements externes
Un client s’inscrit à votre pop-up store via un formulaire tiers. L’API transmet l’événement à Klaviyo, qui déclenche un flow de remerciement avec une offre personnalisée.
Même logique pour la fidélité. Votre outil envoie par l’API le passage d’un client au statut VIP, et Klaviyo lance la campagne exclusive réservée à ce palier. Nos scénarios personnalisés partent presque tous d’un déclencheur de ce type, et notre guide des flows Klaviyo détaille les architectures qui tiennent dans la durée.
Segmenter à partir de vos données externes
Branchez un CRM ou un entrepôt de données, et vos segments Klaviyo peuvent s’appuyer sur :
- la valeur vie client (LTV),
- le score de fidélité,
- la famille de produits achetée,
- ou le canal d’acquisition.
Vos promotions, vos contenus et votre planning d’envoi s’appuient alors sur des critères que les intégrations natives ne remontent pas.
💡 Tip Standard Ecom
Stockez chaque donnée externe dans une propriété dédiée et préfixée, du type crm_score_fidelite, plutôt que dans un champ Klaviyo existant. Vous savez d’où vient chaque valeur, et une synchronisation ratée n’écrase rien.
Centraliser le reporting dans un outil BI
La Reporting API extrait les indicateurs à croiser avec vos autres canaux dans un même tableau de bord :
- revenus attribués
- taux d’ouverture et de clic
- panier moyen
- évolution des segments
Les chiffres descendent jusqu’au message d’une campagne, ce qui permet de comparer deux variantes d’un même envoi. Vos équipes lisent ainsi l’attribution des revenus au même endroit que le reste de leurs données.
Bonnes pratiques et erreurs à éviter avec l’API Klaviyo
Un premier appel qui fonctionne, ce n’est que le début : ce qui compte, c’est que la synchronisation tienne dans six mois. Voici les six points que nous vérifions à chaque audit, avec l’incident que chacun évite.
Bonnes pratiques API Klaviyo · relevé de nos audits · septembre 2026
| Bonne pratique | L’incident qu’elle écarte | Le repère technique |
|---|---|---|
| Ne jamais exposer une clé privée | Clé récupérée dans un dépôt Git public ou un script front | Appels côté serveur, nouvelle clé et désactivation de l’ancienne en cas de fuite |
| Appliquer le moindre privilège | Une intégration compromise ouvre l’ensemble du compte | Une clé par intégration, niveau Personnalisée, permissions strictement utiles |
| Respecter les limites d’appels | Requêtes rejetées en erreur 429 et données perdues | De 1 à 350 appels par seconde en pic selon l’endpoint, relance en backoff exponentiel |
| Figer la version de l’API | Rupture silencieuse à la prochaine évolution | En-tête revision daté sur chaque requête |
| Surveiller les codes d’erreur | Synchronisation morte repérée des semaines après | Alerte automatique sur les codes 4xx et 5xx |
| Suivre la documentation officielle | Endpoint retiré ou spécification modifiée sans préavis | Veille sur le portail développeurs de Klaviyo |
Ces limites évoluent, vérifiez-les dans la documentation développeurs avant toute mise en production.
🎯 L’avis d’expert
« Chez Darwin Microfluidics, une partie de la donnée la plus utile n’était pas dans la boutique, mais dans leur entrepôt de données. On y a identifié chaque client comme laboratoire académique ou industriel, puis on a envoyé cette information dans Klaviyo par l’API. Les emails peuvent ainsi relancer chaque labo au moment où son budget se renouvelle, avec un message adapté. »
Pourquoi se faire accompagner pour intégrer l’API Klaviyo ?
Une intégration mal cadrée coûte plus cher à corriger qu’à bien faire dès le départ. Un mauvais identifiant crée des doublons, un champ mal nommé mélange deux sources, et un import sans consentement expose la marque au RGPD.
Nous accompagnons des marques comme Chloé, Jimmy Fairly, Mustela ou Delsey dans la configuration technique et l’optimisation de leur compte Klaviyo, comme le montrent nos études de cas.
Notre équipe intervient sur :
- la connexion API avec vos outils existants, ERP, CRM et BI
- la structuration des données clients et le nommage des propriétés
- l’architecture des flows automatisés qui consomment ces données
Réservez votre diagnostic CRM offert →
📖 À lire aussiVous êtes sur Shopify ? Lisez notre guide Klaviyo et Shopify : intégration et optimisation.
Vos questions fréquentes sur l’API Klaviyo
Quelle est la différence entre la clé API publique et la clé API privée de Klaviyo ?
La clé publique, ou identifiant de site, sert aux API client et peut être visible dans le code de votre site. Elle permet d’envoyer des inscriptions et des événements : protégez vos formulaires. La clé privée lit et modifie profils, listes et abonnements, et ne doit jamais quitter votre serveur.
L’API Klaviyo est-elle compatible avec Shopify, Magento et les CMS headless ?
Oui. Shopify, WooCommerce, Magento 2, PrestaShop et BigCommerce ont une intégration native qui installe le script de suivi automatiquement. Les boutiques headless et les plateformes maison passent par les API serveur et les API client, avec un script de suivi ajouté à la main.
Combien de clés API privées peut-on créer sur un compte Klaviyo ?
Autant que nécessaire. Créez-en une par intégration, avec des permissions restreintes à son usage, pour tracer l’origine des données et révoquer un accès sans couper les autres.
Que faire si une clé API privée Klaviyo a été exposée publiquement ?
Créez une nouvelle clé, mettez à jour l’intégration concernée, puis désactivez l’ancienne dans l’onglet Clés d’API. Vérifiez ensuite les événements reçus pendant l’exposition, pour repérer une écriture suspecte.
Faut-il des compétences en développement pour utiliser l’API Klaviyo ?
Pour un appel de test, non : une ligne cURL suffit. En production, oui, parce que la gestion des erreurs, des limites d’appels et des versions demande du code maintenu, souvent confié à une agence.
Peut-on envoyer des données de Klaviyo vers un autre outil ?
Oui. Un webhook placé dans un flow envoie une information à l’outil de votre choix au moment où un client atteint cette étape. Pour récupérer des données en masse, profils ou résultats de campagne, vos outils interrogent directement l’API.
