---
title: "HubSpot API: what it is and where to start"
description: "What the HubSpot API is: how authentication works now, the new date-based versions, the main endpoint families and the fastest way to make a first call."
url: "https://jetstack.ai/answers/hubspot-api/"
---

# 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.

![](https://jetstack.ai/images/authors/aditya-kumar.webp)

By [Aditya Kumar](https://jetstack.ai/authors/aditya-kumar/) Founder, Jetstack AI

Updated October 29, 2026

On this page

## What HubSpot supports natively

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

| Area                     | Examples                                                                                                       |
| ------------------------ | -------------------------------------------------------------------------------------------------------------- |
| CRM objects              | Contacts, companies, deals, tickets, custom objects, associations                                              |
| CRM search               | Filtered search across objects (its own limits: 5 requests per second, 200 results per page, 10,000 per query) |
| Properties and pipelines | Create and edit property definitions, pipelines and stages                                                     |
| Automation               | Workflows (v4 Automation API, in beta)                                                                         |
| Marketing and content    | Forms, 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:

| Credential               | Use it for                                                                            |
| ------------------------ | ------------------------------------------------------------------------------------- |
| Service key              | Scripts and simple integrations in your own account                                   |
| Legacy private app token | Existing integrations only; creation closed on October 26, 2026 for existing accounts |
| OAuth                    | Apps 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](https://jetstack.ai/answers/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](https://jetstack.ai/docs/developers) and [authentication](https://jetstack.ai/docs/developers/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](https://jetstack.ai/build) 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

- [Introducing date-based API versioning (HubSpot Developer Changelog)](https://developers.hubspot.com/changelog/introducing-date-based-api-versioning)
- [Account service keys (HubSpot Developers)](https://developers.hubspot.com/docs/apps/developer-platform/build-apps/authentication/account-service-keys)
- [HubSpot account types (HubSpot Developers)](https://developers.hubspot.com/docs/getting-started/account-types)
- [Developers overview (Jetstack AI documentation)](https://jetstack.ai/docs/developers)

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

![Aditya Kumar](https://jetstack.ai/images/authors/aditya-kumar.webp)

About the author

[Aditya Kumar](https://jetstack.ai/authors/aditya-kumar/)

Founder, Jetstack AI

Aditya Kumar is the founder of Jetstack AI, the AI platform HubSpot partners and RevOps teams use to audit portals, build implementations and reuse their best setups across portals. He writes about HubSpot architecture, automation and AI from the work of building it.

[More from Aditya](https://jetstack.ai/authors/aditya-kumar/) [LinkedIn](https://www.linkedin.com/in/aditya-ambrstack/)

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](https://jetstack.ai/docs/developers)

On this page

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.
