> ## Documentation Index > Fetch the complete documentation index at: https://developers.hubspot.com/docs/llms.txt > Use this file to discover all available pages before exploring further. --- id: 19792dfa-a653-4348-a12f-57f801f6b92a --- # Legacy API reference > Reference documentation for HubSpot's legacy numeric-versioned APIs (v1–v4). **Please note:** the APIs in this section use legacy numeric versioning (v1, v2, v3, v4) and will be deprecated in a future release. For new integrations, use the [2026-03 APIs](/api-reference/latest/overview) instead. Migrating to the date-based version path (e.g., `/crm/objects/2026-03/contacts`) positions your integration for long-term support as HubSpot moves forward with date-versioned releases. The Legacy API reference covers HubSpot's older numeric-versioned endpoints. These APIs span four major version levels — v4, v3, v2, and v1 — each reflecting different generations of the HubSpot platform. Endpoints follow the pattern: ```text theme={null} /api-name/v{version}/resource ``` For example, to retrieve a contact using the v3 CRM objects API: ```bash theme={null} GET /crm/v3/objects/contacts/{contactId} ``` ## APIs by version ### v4 The v4 endpoints represent HubSpot's most recent pre-date-versioning APIs, covering associations and automation actions. * **CRM Associations v4:** (`/crm/v4/associations/`, `/crm/v4/objects/{objectType}/{objectId}/associations/`) create, read, and delete associations between records; configure association labels and types * **Automation workflow actions v4:** (`/automation/v4/actions/`) define custom workflow actions with input fields, execution callbacks, and action definitions *** ### v3 Most of HubSpot's core platform APIs are at v3. These include the primary CRM, CMS, automation, and marketing endpoints. * **CRM objects v3:** (`/crm/v3/objects/{objectType}`) CRUD and batch operations for contacts, companies, deals, tickets, and all other standard and custom CRM objects; includes search, merge, GDPR delete, and schema management * **CRM associations v3:** (`/crm/v3/associations/{fromObjectType}/{toObjectType}/batch/`) batch read, create, and delete associations * **CRM properties v3:** (`/crm/v3/properties/{objectType}`) create and manage object properties and property groups * **CRM pipelines v3:** (`/crm/v3/pipelines/{objectType}`) manage deal and ticket pipelines and stages * **CRM imports/exports v3:** (`/crm/v3/imports/`, `/crm/v3/exports/`) bulk import and export CRM records * **CRM lists v3:** (`/crm/v3/lists/`) create and manage contact and company lists * **CRM extensions v3:** (`/crm/v3/extensions/`) calling extensions and video conferencing integrations * **Automation workflows v3:** (`/automation/v3/workflows/`) create, retrieve, and delete HubSpot workflows * **Conversations v3:** (`/conversations/v3/`) manage inboxes, threads, messages, and custom channels * **CMS v3:** (`/cms/v3/`) blog posts, pages, HubDB, source code, domains, URL mappings, and redirects * **Marketing events v3:** (`/marketing/v3/marketing-events/`) create and manage marketing event records and attendance * **Communication preferences v3:** (`/communication-preferences/v3/`) manage subscription definitions and statuses * **Webhooks v3:** (`/webhooks/v3/`) configure webhook subscriptions and settings * **Events v3:** (`/events/v3/`) send and manage custom behavioral events * **Files v3:** (`/files/v3/`) upload, manage, and retrieve files and folders *** ### v2 The v2 APIs are older versions of CRM and CMS endpoints, many of which have v3 replacements. * **CRM properties v2:** (`/properties/v2/{objectType}/properties`) manage contact, company, and deal properties and property groups * **CRM companies v2:** (`/companies/v2/companies/`) create, read, update, and delete company records * **CRM deals v2:** (overlaps with v1; some batch update endpoints at deal-level paths) * **CMS blog posts v2:** (`/content/api/v2/blog-posts/`) manage blog post drafts, versions, and publishing * **CMS pages v2:** (`/content/api/v2/pages/`) manage website and landing pages * **CMS blog settings v2:** (`/content/api/v2/blogs/`) read blog configuration * **CMS site search v2:** (`/site-search/v2/`) search indexed site content and retrieve indexed properties * **CMS layouts and templates v2:** (`/content/api/v2/`) manage CMS templates and layouts * **Automation workflows v2:** (`/automation/v2/workflows/`) manage workflow enrollment for contacts * **Marketing forms v2:** (`/forms/v2/forms/`) create, read, update, and delete HubSpot forms; retrieve field definitions *** ### v1 The v1 APIs are the oldest generation and are primarily legacy contacts, deals, engagements, and account endpoints. * **CRM contacts v1:** (`/contacts/v1/`) create, read, update, and delete contacts; manage secondary emails; batch operations; search * **CRM deals v1:** (`/deals/v1/deal/`) create, read, update, and delete deal records; batch async updates * **CRM line items v1:** (`/crm-objects/v1/objects/line-items/`) manage line item records and batch operations * **CRM products v1:** (`/crm-objects/v1/objects/products/`) manage product records * **CRM tickets v1:** (`/crm-objects/v1/objects/tickets/`) manage ticket records * **CRM owners v2:** (`/owners/v2/owners/`) retrieve CRM owners * **CRM pipelines v1:** (`/crm-pipelines/v1/pipelines/{objectType}`) manage pipelines and stages * **CRM lists v1:** (`/contacts/v1/lists/`) create and manage static and dynamic contact lists * **CRM associations v1:** (`/crm-associations/v1/associations/`) create, read, and delete associations between objects * **CRM engagements v1:** (`/engagements/v1/engagements/`) create and manage calls, emails, meetings, notes, and tasks as engagement records * **CRM extensions v1:** (`/extensions/sales-objects/v1/`) configure CRM card object types * **Account info v1:** (`/integrations/v1/me`) retrieve basic information about the authenticated account * **Communication preferences v1:** (`/email/public/v1/subscriptions/`) read and update email subscription statuses * **Marketing forms v1:** (`/form-integrations/v1/`) retrieve form submissions and signed file URLs * **Marketing transactional send v1:** (`/email/public/v1/singleEmail/send`) send single transactional emails; manage SMTP API tokens * **CMS domains v1:** (`/cms/v1/domains/`) list and retrieve CMS domain configurations * **Reporting v2:** (`/analytics/v2/reports/`) retrieve analytics data for content and events