Skip to content
Book a build

What is the HubSpot API, and where do you start?

The HubSpot API is HubSpot's set of REST endpoints at api.hubapi.com for reading and changing CRM records, properties, pipelines, workflows, marketing assets and more. Start with a service key for your own account (API keys were retired in 2022), call an endpoint with it as a Bearer token, and use a free developer test account so you don't experiment on production data.

On this page

What HubSpot supports natively

HubSpot exposes almost everything in the product over REST. The parts most admins and RevOps developers touch:

AreaExamples
CRM objectsContacts, companies, deals, tickets, custom objects, associations
CRM searchFiltered search across objects (its own limits: 5 requests per second, 200 results per page, 10,000 per query)
Properties and pipelinesCreate and edit property definitions, pipelines and stages
AutomationWorkflows (v4 Automation API, in beta)
Marketing and contentForms, marketing emails, pages, blog posts, HubDB

Versions. In March 2026 HubSpot moved to date-based versions such as /2026-03/, released every March and September and supported for at least 18 months. The v1 to v3 paths still work, and HubSpot hasn’t announced when they end. New integrations should use the latest dated version.

Authentication. API keys were retired on November 30, 2022. Today:

CredentialUse it for
Service keyScripts and simple integrations in your own account
Legacy private app tokenExisting integrations only; creation closed on October 26, 2026 for existing accounts
OAuthApps that other HubSpot accounts install

How to make your first HubSpot API call

  1. Create a developer test account (free, up to 10 per standard account, with a 90-day trial of many Enterprise features) or use a sandbox.
  2. Create a service key in that account under Development → Keys → Service keys, with only the scopes you need, for example crm.objects.contacts.read.
  3. Call an endpoint with the key as a Bearer token in the Authorization header, for example a GET on the contacts objects endpoint.
  4. Read the rate limit headers in the response before you write a loop. See HubSpot API rate limits.
  5. Move to production with a new key in that account. Keys are per account.

Where Jetstack AI fits

Jetstack AI has its own REST API at https://api.jetstack.ai that works one level up from HubSpot’s: list connected portals, browse a portal’s assets, import them with dependencies, deploy them to another portal with a mapping, and run portal and workflow audits. It uses Jetstack keys with their own scopes and limits (5 requests per second, 100 per minute per key). Start with the developer overview and authentication. If you’re reaching for the API to set up a portal (properties, pipelines, workflows) rather than to build an integration, we recommend Projects instead: you describe the build in a brief, approve a plan and a separate deployment, and get a receipt read back from HubSpot. It’s currently in limited release.

Sources

Checked October 29, 2026. HubSpot changes its products often; tell us at team@jetstack.ai if something here is out of date.

API & developers

Do it from your own code or AI agent.

The Jetstack AI REST API, MCP server and CLI share API keys and scopes. Create and manage those keys in the app.

Read the developer docs

API & developers

Related questions.

What is the HubSpot API, and where do you start?

The HubSpot API is HubSpot's set of REST endpoints at api.hubapi.com for reading and changing CRM records, properties, pipelines, workflows, marketing assets and more. Start with a service key for your own account (API keys were retired in 2022), call an endpoint with it as a Bearer token, and use a free developer test account so you don't experiment on production data.

What are HubSpot's date-based API versions?

Since March 2026 HubSpot publishes API versions with a date in the path, such as /2026-03/, released twice a year in March and September. Each version is supported for at least 18 months, and the older v1 to v3 paths keep working for now with no end date announced.

Which authentication should I use?

A service key for a script or integration in your own account. OAuth for an app that other HubSpot accounts install. Existing legacy private app tokens keep working, but new ones can no longer be created.

Is there an official HubSpot API client?

HubSpot publishes client libraries alongside its API reference, and every endpoint can also be called directly over HTTPS with any HTTP client.