Passer au contenu principal
Veuillez noter : les API de cette section utilisent l’ancien versionnement numérique (v1, v2, v3, v4) et seront dépréciées dans une future version. Pour les nouvelles intégrations, utilisez les API 2026-03 à la place. Migrer vers le chemin de version basé sur la date (par exemple, /crm/objects/2026-03/contacts) positionne votre intégration pour un support à long terme alors que HubSpot adopte les versions datées.
La référence API héritée couvre les anciens endpoints de HubSpot versionnés numériquement. Ces API s’étendent sur quatre niveaux de version majeurs — v4, v3, v2 et v1 — chacun reflétant différentes générations de la plateforme HubSpot. Les endpoints suivent le schéma : 
/api-name/v{version}/resource
Par exemple, pour récupérer un contact avec l’API CRM objects v3 : 
GET /crm/v3/objects/contacts/{contactId}

​
API par version

​
v4

Les endpoints v4 représentent les API les plus récentes de HubSpot avant le versionnement par date, couvrant les associations et les actions d’automatisation.
  • CRM Associations v4 : (/crm/v4/associations/, /crm/v4/objects/{objectType}/{objectId}/associations/) créer, lire et supprimer des associations entre les enregistrements ; configurer les libellés et types d’associations
  • Automation workflow actions v4 : (/automation/v4/actions/) définir des actions de workflow personnalisées avec des champs de saisie, des callbacks d’exécution et des définitions d’actions

​
v3

La plupart des API principales de la plateforme HubSpot sont en v3. Celles-ci incluent les principaux endpoints CRM, CMS, automatisation et marketing.
  • CRM objects v3 : (/crm/v3/objects/{objectType}) opérations CRUD et par lots pour les contacts, entreprises, transactions, tickets et tous les autres objets CRM standard et personnalisés ; inclut la recherche, la fusion, la suppression RGPD et la gestion des schémas
  • CRM associations v3 : (/crm/v3/associations/{fromObjectType}/{toObjectType}/batch/) lecture, création et suppression par lots des associations
  • CRM properties v3 : (/crm/v3/properties/{objectType}) créer et gérer les propriétés d’objets et les groupes de propriétés
  • CRM pipelines v3 : (/crm/v3/pipelines/{objectType}) gérer les pipelines et les étapes des transactions et tickets
  • CRM imports/exports v3 : (/crm/v3/imports/, /crm/v3/exports/) import et export en masse des enregistrements CRM
  • CRM lists v3 : (/crm/v3/lists/) créer et gérer les listes de contacts et d’entreprises
  • CRM extensions v3 : (/crm/v3/extensions/) extensions d’appels et intégrations de vidéoconférence
  • Automation workflows v3 : (/automation/v3/workflows/) créer, récupérer et supprimer des workflows HubSpot
  • Conversations v3 : (/conversations/v3/) gérer les boîtes de réception, fils de discussion, messages et canaux personnalisés
  • CMS v3 : (/cms/v3/) articles de blog, pages, HubDB, code source, domaines, mappages d’URL et redirections
  • Marketing events v3 : (/marketing/v3/marketing-events/) créer et gérer les enregistrements d’événements marketing et les participations
  • Communication preferences v3 : (/communication-preferences/v3/) gérer les définitions et statuts d’abonnement
  • Webhooks v3 : (/webhooks/v3/) configurer les abonnements et paramètres de webhooks
  • Events v3 : (/events/v3/) envoyer et gérer les événements comportementaux personnalisés
  • Files v3 : (/files/v3/) télécharger, gérer et récupérer des fichiers et dossiers

​
v2

Les API v2 sont des versions plus anciennes des endpoints CRM et CMS, dont beaucoup ont des remplacements en v3.
  • CRM properties v2 : (/properties/v2/{objectType}/properties) gérer les propriétés et groupes de propriétés des contacts, entreprises et transactions
  • CRM companies v2 : (/companies/v2/companies/) créer, lire, mettre à jour et supprimer des enregistrements d’entreprises
  • CRM deals v2 : (chevauchement avec v1 ; certains endpoints de mise à jour par lots au niveau des transactions)
  • CMS blog posts v2 : (/content/api/v2/blog-posts/) gérer les brouillons, versions et publications d’articles de blog
  • CMS pages v2 : (/content/api/v2/pages/) gérer les pages de site web et les pages de destination
  • CMS blog settings v2 : (/content/api/v2/blogs/) lire la configuration du blog
  • CMS site search v2 : (/site-search/v2/) rechercher le contenu indexé du site et récupérer les propriétés indexées
  • CMS layouts and templates v2 : (/content/api/v2/) gérer les modèles et mises en page CMS
  • Automation workflows v2 : (/automation/v2/workflows/) gérer l’inscription des contacts aux workflows
  • Marketing forms v2 : (/forms/v2/forms/) créer, lire, mettre à jour et supprimer des formulaires HubSpot ; récupérer les définitions de champs

​
v1

Les API v1 sont la génération la plus ancienne et concernent principalement les contacts, transactions, engagements et endpoints de compte hérités.
  • CRM contacts v1 : (/contacts/v1/) créer, lire, mettre à jour et supprimer des contacts ; gérer les e-mails secondaires ; opérations par lots ; recherche
  • CRM deals v1 : (/deals/v1/deal/) créer, lire, mettre à jour et supprimer des enregistrements de transactions ; mises à jour asynchrones par lots
  • CRM line items v1 : (/crm-objects/v1/objects/line-items/) gérer les enregistrements de lignes de produits et les opérations par lots
  • CRM products v1 : (/crm-objects/v1/objects/products/) gérer les enregistrements de produits
  • CRM tickets v1 : (/crm-objects/v1/objects/tickets/) gérer les enregistrements de tickets
  • CRM owners v2 : (/owners/v2/owners/) récupérer les propriétaires CRM
  • CRM pipelines v1 : (/crm-pipelines/v1/pipelines/{objectType}) gérer les pipelines et les étapes
  • CRM lists v1 : (/contacts/v1/lists/) créer et gérer les listes de contacts statiques et dynamiques
  • CRM associations v1 : (/crm-associations/v1/associations/) créer, lire et supprimer des associations entre objets
  • CRM engagements v1 : (/engagements/v1/engagements/) créer et gérer les appels, e-mails, réunions, notes et tâches en tant qu’enregistrements d’engagement
  • CRM extensions v1 : (/extensions/sales-objects/v1/) configurer les types d’objets des cartes CRM
  • Account info v1 : (/integrations/v1/me) récupérer les informations de base sur le compte authentifié
  • Communication preferences v1 : (/email/public/v1/subscriptions/) lire et mettre à jour les statuts d’abonnement aux e-mails
  • Marketing forms v1 : (/form-integrations/v1/) récupérer les soumissions de formulaires et les URL de fichiers signés
  • Marketing transactional send v1 : (/email/public/v1/singleEmail/send) envoyer des e-mails transactionnels individuels ; gérer les tokens API SMTP
  • CMS domains v1 : (/cms/v1/domains/) lister et récupérer les configurations de domaines CMS
  • Reporting v2 : (/analytics/v2/reports/) récupérer les données analytiques pour le contenu et les événements
Last modified on April 2, 2026