{"slug":"hubspot-api","name":"HubSpot API","host":"api.hubapi.com","site":"https://hubapi.com","category":"marketing","docsUrl":null,"sources":[{"kind":"changelog","url":"https://developers.hubspot.com/changelog"},{"kind":"openapi","url":"https://raw.githubusercontent.com/HubSpot/HubSpot-public-api-spec-collection/main/PublicApiSpecs/CRM/Contacts/Rollouts/424/v3/contacts.json"},{"kind":"openapi","url":"https://raw.githubusercontent.com/HubSpot/HubSpot-public-api-spec-collection/main/PublicApiSpecs/CRM/Objects/Rollouts/424/2026-09/objects.json"},{"kind":"openapi","url":"https://raw.githubusercontent.com/HubSpot/HubSpot-public-api-spec-collection/main/PublicApiSpecs/CRM/Objects/Rollouts/424/v3/objects.json"},{"kind":"archive","url":"https://developers.hubspot.com/changelog/deprecating-support-for-hubspot-v4-apis"},{"kind":"archive","url":"https://developers.hubspot.com/changelog/legacy-apis-and-legacy-apps-whats-going-unsupported-and-when"},{"kind":"archive","url":"https://developers.hubspot.com/changelog/pipelines-api-v1-sunset"},{"kind":"archive","url":"https://developers.hubspot.com/docs/api-reference/deprecated-apis"}],"url":"https://www.okapi.bot/providers/hubspot-api/","json":"https://www.okapi.bot/api/v1/providers/hubspot-api.json","breakingChanges":[{"slug":"pipelines-api-v1-stops-working","api":"hubspot-api","title":"Pipelines API V1 stops working","kind":"version_retirement","outcome":"fails","model":null,"announcedAt":"2026-08-14","effectiveAt":"2026-12-04","scope":null,"calls":["/v1/*"],"method":null,"path":"/v1/*","source":{"url":"https://developers.hubspot.com/changelog","kind":"changelog"},"quote":"HubSpot will sunset the Pipelines API V1 on December 4, 2026. After this date, the API will no longer be supported.","migration":"If your integration relies on V1 endpoints, you'll need to migrate to the 2026-03 or later version.","migrationChange":null,"needsDecision":null,"text":{"summary":"Pipelines API V1 will shut down on December 4, 2026. This change impacts calls to /v1/* endpoints. After this date, these calls will fail as the API will no longer be supported.","migration":"If your integration relies on V1 endpoints, migrate to the 2026-03 or later version.","by":"writer"},"publishedAt":"2026-10-23T11:52:57.078Z","updatedAt":"2026-10-23T12:52:23.948Z","status":"upcoming","tone":"risk","url":"https://www.okapi.bot/providers/hubspot-api/breaking-changes/pipelines-api-v1-stops-working/"},{"slug":"the-pipelines-api-v1-stops-working","api":"hubspot-api","title":"The Pipelines API v1 stops working","kind":"version_retirement","outcome":"fails","model":null,"announcedAt":"2026-08-14","effectiveAt":"2026-12-04","scope":null,"calls":["/crm-pipelines/v1/*"],"method":null,"path":"/crm-pipelines/v1/*","source":{"url":"https://developers.hubspot.com/changelog/pipelines-api-v1-sunset","kind":"archive"},"quote":"The Pipelines API V1 is being permanently retired. Any calls to V1 endpoints will stop working after December 4, 2026.","migration":"Call the Pipelines API version 2026-09 (/crm/pipelines/2026-09/{objectType}).","migrationChange":null,"needsDecision":null,"text":{"summary":"On December 4, 2026, the Pipelines API v1 will be permanently retired. Calls to endpoints under /crm-pipelines/v1/* will stop working on that date. Requests made to these paths will fail after the shutdown.","migration":"Call the Pipelines API version 2026-09 at /crm/pipelines/2026-09/{objectType} instead.","by":"writer"},"publishedAt":"2026-10-23T10:27:43.269Z","updatedAt":"2026-10-23T10:52:56.206Z","status":"upcoming","tone":"risk","url":"https://www.okapi.bot/providers/hubspot-api/breaking-changes/the-pipelines-api-v1-stops-working/"},{"slug":"the-contact-lists-api-v1-stops-working","api":"hubspot-api","title":"The Contact Lists API v1 stops working","kind":"version_retirement","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":"2026-04-30","scope":null,"calls":["/contacts/v1/lists*"],"method":null,"path":"/contacts/v1/lists*","source":{"url":"https://developers.hubspot.com/docs/api-reference/deprecated-apis","kind":"archive"},"quote":"Contact lists v1 | April 30, 2026 | Create and manage contact lists with the latest lists API.","migration":"Manage lists with the Lists API (/crm/v3/lists, or /crm/lists/2026-09).","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T10:27:45.263Z","updatedAt":"2026-10-23T10:27:45.263Z","status":"in_effect","tone":"broken","url":"https://www.okapi.bot/providers/hubspot-api/breaking-changes/the-contact-lists-api-v1-stops-working/"},{"slug":"the-hubdb-v2-api-stops-working","api":"hubspot-api","title":"The HubDB v2 API stops working","kind":"version_retirement","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":"2024-12-16","scope":null,"calls":["/hubdb/api/v2/*"],"method":null,"path":"/hubdb/api/v2/*","source":{"url":"https://developers.hubspot.com/docs/api-reference/deprecated-apis","kind":"archive"},"quote":"HubDB v2 | December 16, 2024 | Continue working with HubDB via the HubDB v3 API instead","migration":"Call the HubDB v3 API (/cms/v3/hubdb/*).","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T10:27:45.263Z","updatedAt":"2026-10-23T10:27:45.263Z","status":"in_effect","tone":"broken","url":"https://www.okapi.bot/providers/hubspot-api/breaking-changes/the-hubdb-v2-api-stops-working/"},{"slug":"the-cms-performance-api-stops-working","api":"hubspot-api","title":"The CMS performance API stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":"2024-04-09","scope":null,"calls":["GET /cms/v3/performance*"],"method":"GET","path":"/cms/v3/performance*","source":{"url":"https://developers.hubspot.com/docs/api-reference/deprecated-apis","kind":"archive"},"quote":"CMS performance | April 9, 2024 | For website analytics data, use the analytics API.","migration":"Read website analytics with the analytics API (/analytics/v2/reports/*).","migrationChange":null,"needsDecision":"The analytics API reports other figures than CMS performance; whether they serve the same purpose is the team's call.","text":null,"publishedAt":"2026-10-23T10:27:45.263Z","updatedAt":"2026-10-23T10:27:45.263Z","status":"in_effect","tone":"broken","url":"https://www.okapi.bot/providers/hubspot-api/breaking-changes/the-cms-performance-api-stops-working/"},{"slug":"the-marketing-calendar-api-stops-working","api":"hubspot-api","title":"The Marketing Calendar API stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":"2023-08-31","scope":null,"calls":["/calendar/v1/*"],"method":null,"path":"/calendar/v1/*","source":{"url":"https://developers.hubspot.com/docs/api-reference/deprecated-apis","kind":"archive"},"quote":"Marketing calendar | August 31, 2023 | You can continue to use the marketing calendar in HubSpot.","migration":"No API replaces it; use the marketing calendar in HubSpot's app.","migrationChange":null,"needsDecision":"HubSpot offers no API in its place.","text":null,"publishedAt":"2026-10-23T10:27:45.263Z","updatedAt":"2026-10-23T10:27:45.263Z","status":"in_effect","tone":"broken","url":"https://www.okapi.bot/providers/hubspot-api/breaking-changes/the-marketing-calendar-api-stops-working/"},{"slug":"the-accounting-extension-api-stops-working","api":"hubspot-api","title":"The Accounting Extension API stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":"2023-02-28","scope":null,"calls":["/crm/v3/extensions/accounting/*"],"method":null,"path":"/crm/v3/extensions/accounting/*","source":{"url":"https://developers.hubspot.com/docs/api-reference/deprecated-apis","kind":"archive"},"quote":"Accounting extension | February 28, 2023 | Integrations should switch to using HubSpot’s CRM v3 APIs, with calls authenticated by an app.","migration":"Write invoices and related records with the CRM v3 object APIs (/crm/v3/objects/*).","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T10:27:45.263Z","updatedAt":"2026-10-23T10:27:45.263Z","status":"in_effect","tone":"broken","url":"https://www.okapi.bot/providers/hubspot-api/breaking-changes/the-accounting-extension-api-stops-working/"},{"slug":"the-ecommerce-bridge-api-stops-working","api":"hubspot-api","title":"The Ecommerce Bridge API stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":"2023-02-28","scope":null,"calls":["/extensions/ecomm/v2/*"],"method":null,"path":"/extensions/ecomm/v2/*","source":{"url":"https://developers.hubspot.com/docs/api-reference/deprecated-apis","kind":"archive"},"quote":"Ecommerce bridge | February 28, 2023 | Integrations should switch to using HubSpot’s CRM v3 APIs, with calls authenticated by an app.","migration":"Write products, deals and line items with the CRM v3 object APIs (/crm/v3/objects/*).","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T10:27:45.263Z","updatedAt":"2026-10-23T10:27:45.263Z","status":"in_effect","tone":"broken","url":"https://www.okapi.bot/providers/hubspot-api/breaking-changes/the-ecommerce-bridge-api-stops-working/"},{"slug":"the-automation-v4-api-is-deprecated","api":"hubspot-api","title":"The Automation v4 API is deprecated","kind":"version_retirement","outcome":"fails","model":null,"announcedAt":"2026-05-21","effectiveAt":null,"scope":null,"calls":["/automation/v4/*"],"method":null,"path":"/automation/v4/*","source":{"url":"https://developers.hubspot.com/changelog/deprecating-support-for-hubspot-v4-apis","kind":"archive"},"quote":"In March 2027, HubSpot v4 APIs will move to an unsupported state. After that date, v4 APIs will no longer receive updates, bug fixes, or stability guarantees from HubSpot.","migration":"Move to the latest date-based API version, 2026-09.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T10:28:00.271Z","updatedAt":"2026-10-23T10:28:00.271Z","status":"deprecated","tone":"deprecated","url":"https://www.okapi.bot/providers/hubspot-api/breaking-changes/the-automation-v4-api-is-deprecated/"},{"slug":"the-companies-api-v2-is-deprecated","api":"hubspot-api","title":"The Companies API v2 is deprecated","kind":"version_retirement","outcome":"fails","model":null,"announcedAt":"2026-09-15","effectiveAt":null,"scope":null,"calls":["/companies/v2/*"],"method":null,"path":"/companies/v2/*","source":{"url":"https://developers.hubspot.com/changelog/legacy-apis-and-legacy-apps-whats-going-unsupported-and-when","kind":"archive"},"quote":"Endpoints using numbered version paths, /v1/ , /v2/ , and /v3/ , will move to unsupported status. HubSpot will no longer release bug fixes, reliability improvements, or security updates for these versions.","migration":"Move to the Companies API on date-based versioning (/crm/objects/2026-09/companies).","migrationChange":null,"needsDecision":"HubSpot has not finalized every legacy endpoint's date-based replacement yet; it documents them in its March 2027 release.","text":null,"publishedAt":"2026-10-23T10:28:04.091Z","updatedAt":"2026-10-23T10:28:04.091Z","status":"deprecated","tone":"deprecated","url":"https://www.okapi.bot/providers/hubspot-api/breaking-changes/the-companies-api-v2-is-deprecated/"},{"slug":"the-contacts-api-v1-is-deprecated","api":"hubspot-api","title":"The Contacts API v1 is deprecated","kind":"version_retirement","outcome":"fails","model":null,"announcedAt":"2026-09-15","effectiveAt":null,"scope":null,"calls":["/contacts/v1/*"],"method":null,"path":"/contacts/v1/*","source":{"url":"https://developers.hubspot.com/changelog/legacy-apis-and-legacy-apps-whats-going-unsupported-and-when","kind":"archive"},"quote":"Endpoints using numbered version paths, /v1/ , /v2/ , and /v3/ , will move to unsupported status. HubSpot will no longer release bug fixes, reliability improvements, or security updates for these versions.","migration":"Move to the Contacts API on date-based versioning (/crm/objects/2026-09/contacts).","migrationChange":null,"needsDecision":"HubSpot has not finalized every legacy endpoint's date-based replacement yet; it documents them in its March 2027 release.","text":null,"publishedAt":"2026-10-23T10:28:04.091Z","updatedAt":"2026-10-23T10:28:04.091Z","status":"deprecated","tone":"deprecated","url":"https://www.okapi.bot/providers/hubspot-api/breaking-changes/the-contacts-api-v1-is-deprecated/"},{"slug":"the-crm-v3-api-is-deprecated","api":"hubspot-api","title":"The CRM v3 API is deprecated","kind":"version_retirement","outcome":"fails","model":null,"announcedAt":"2026-09-15","effectiveAt":null,"scope":null,"calls":["/crm/v3/*"],"method":null,"path":"/crm/v3/*","source":{"url":"https://developers.hubspot.com/changelog/legacy-apis-and-legacy-apps-whats-going-unsupported-and-when","kind":"archive"},"quote":"Endpoints using numbered version paths, /v1/ , /v2/ , and /v3/ , will move to unsupported status. HubSpot will no longer release bug fixes, reliability improvements, or security updates for these versions.","migration":"Move to date-based versioning, version 2026-09 (/crm/objects/2026-09/{objectType} for /crm/v3/objects/{objectType}).","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T10:28:04.091Z","updatedAt":"2026-10-23T10:28:04.091Z","status":"deprecated","tone":"deprecated","url":"https://www.okapi.bot/providers/hubspot-api/breaking-changes/the-crm-v3-api-is-deprecated/"},{"slug":"the-crm-v4-api-is-deprecated","api":"hubspot-api","title":"The CRM v4 API is deprecated","kind":"version_retirement","outcome":"fails","model":null,"announcedAt":"2026-05-21","effectiveAt":null,"scope":null,"calls":["/crm/v4/*"],"method":null,"path":"/crm/v4/*","source":{"url":"https://developers.hubspot.com/changelog/deprecating-support-for-hubspot-v4-apis","kind":"archive"},"quote":"In March 2027, HubSpot v4 APIs will move to an unsupported state. After that date, v4 APIs will no longer receive updates, bug fixes, or stability guarantees from HubSpot.","migration":"Move to the latest date-based API version, 2026-09 (/crm/associations/2026-09/*, /crm/objects/2026-09/*).","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T10:28:00.271Z","updatedAt":"2026-10-23T10:28:00.271Z","status":"deprecated","tone":"deprecated","url":"https://www.okapi.bot/providers/hubspot-api/breaking-changes/the-crm-v4-api-is-deprecated/"},{"slug":"the-deals-api-v1-is-deprecated","api":"hubspot-api","title":"The Deals API v1 is deprecated","kind":"version_retirement","outcome":"fails","model":null,"announcedAt":"2026-09-15","effectiveAt":null,"scope":null,"calls":["/deals/v1/*"],"method":null,"path":"/deals/v1/*","source":{"url":"https://developers.hubspot.com/changelog/legacy-apis-and-legacy-apps-whats-going-unsupported-and-when","kind":"archive"},"quote":"Endpoints using numbered version paths, /v1/ , /v2/ , and /v3/ , will move to unsupported status. HubSpot will no longer release bug fixes, reliability improvements, or security updates for these versions.","migration":"Move to the Deals API on date-based versioning (/crm/objects/2026-09/deals).","migrationChange":null,"needsDecision":"HubSpot has not finalized every legacy endpoint's date-based replacement yet; it documents them in its March 2027 release.","text":null,"publishedAt":"2026-10-23T10:28:04.091Z","updatedAt":"2026-10-23T10:28:04.091Z","status":"deprecated","tone":"deprecated","url":"https://www.okapi.bot/providers/hubspot-api/breaking-changes/the-deals-api-v1-is-deprecated/"},{"slug":"the-engagements-api-v1-is-deprecated","api":"hubspot-api","title":"The Engagements API v1 is deprecated","kind":"version_retirement","outcome":"fails","model":null,"announcedAt":"2026-09-15","effectiveAt":null,"scope":null,"calls":["/engagements/v1/*"],"method":null,"path":"/engagements/v1/*","source":{"url":"https://developers.hubspot.com/changelog/legacy-apis-and-legacy-apps-whats-going-unsupported-and-when","kind":"archive"},"quote":"Endpoints using numbered version paths, /v1/ , /v2/ , and /v3/ , will move to unsupported status. HubSpot will no longer release bug fixes, reliability improvements, or security updates for these versions.","migration":"Move to the activity object APIs on date-based versioning (/crm/objects/2026-09/{notes|calls|emails|meetings|tasks}).","migrationChange":null,"needsDecision":"HubSpot has not finalized every legacy endpoint's date-based replacement yet; it documents them in its March 2027 release.","text":null,"publishedAt":"2026-10-23T10:28:04.091Z","updatedAt":"2026-10-23T10:28:04.091Z","status":"deprecated","tone":"deprecated","url":"https://www.okapi.bot/providers/hubspot-api/breaking-changes/the-engagements-api-v1-is-deprecated/"},{"slug":"the-social-media-api-is-deprecated","api":"hubspot-api","title":"The Social Media API is deprecated","kind":"removal","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":null,"scope":null,"calls":["/broadcast/v1/*"],"method":null,"path":"/broadcast/v1/*","source":{"url":"https://developers.hubspot.com/docs/api-reference/deprecated-apis","kind":"archive"},"quote":"The legacy endpoints listed below will not be getting a version update. These endpoints are functional and stable, but won’t be updated beyond their current version.","migration":"No replacement is announced; the endpoints keep working.","migrationChange":null,"needsDecision":"HubSpot names no replacement for its social publishing endpoints.","text":null,"publishedAt":"2026-10-23T10:27:45.263Z","updatedAt":"2026-10-23T10:27:45.263Z","status":"deprecated","tone":"deprecated","url":"https://www.okapi.bot/providers/hubspot-api/breaking-changes/the-social-media-api-is-deprecated/"}]}