> ## Documentation Index > Fetch the complete documentation index at: https://developers.hubspot.fr/docs/llms.txt > Use this file to discover all available pages before exploring further. # Référence API héritée > Documentation de référence pour les anciennes API HubSpot versionnées numériquement (v1–v4). **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](/api-reference/latest/overview) à 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 : ```text theme={null} /api-name/v{version}/resource ``` Par exemple, pour récupérer un contact avec l'API CRM objects v3 : ```bash theme={null} 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