Skip to main content
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 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: 
/api-name/v{version}/resource
For example, to retrieve a contact using the v3 CRM objects API: 
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
Last modified on March 30, 2026