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
- 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.
- Create a service key in that account under Development → Keys → Service keys, with only the scopes you need, for example
crm.objects.contacts.read. - Call an endpoint with the key as a Bearer token in the
Authorizationheader, for example a GET on the contacts objects endpoint. - Read the rate limit headers in the response before you write a loop. See HubSpot API rate limits.
- 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
- Introducing date-based API versioning (HubSpot Developer Changelog)
- Account service keys (HubSpot Developers)
- HubSpot account types (HubSpot Developers)
- Developers overview (Jetstack AI documentation)
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