On this page
What HubSpot supports natively
HubSpot’s usage guidelines, checked October 29, 2026. These apply to legacy private apps, new-platform apps with private distribution, and service keys:
| Subscription | Burst (per 10 seconds) | Daily |
|---|---|---|
| Free and Starter | 100 per app | 250,000 per account |
| Professional | 190 per app | 625,000 per account |
| Enterprise | 190 per app | 1,000,000 per account |
| API limit increase (any tier) | 250 per app | +1,000,000 per account per increase, up to two |
The burst limit applies to each app separately. The daily limit is shared by every app in the account.
Other limits:
| API | Limit |
|---|---|
| Marketplace (publicly distributed) OAuth apps | 110 requests per 10 seconds per installing account; the limit increase doesn’t apply |
| CRM search | 5 requests per second per account; up to 200 results per page and 10,000 per query |
Some APIs are exempt from these limits, and HubSpot warns that very high volume on them can produce 5xx errors.
How to read HubSpot’s rate limit headers
| Header | Meaning |
|---|---|
X-HubSpot-RateLimit-Max | Requests allowed in the current window |
X-HubSpot-RateLimit-Remaining | Requests left in that window |
X-HubSpot-RateLimit-Interval-Milliseconds | Length of the window |
X-HubSpot-RateLimit-Daily / -Daily-Remaining | Daily allowance and what’s left (not sent for OAuth requests) |
The -Secondly headers are deprecated and no longer enforced. Search responses don’t include rate limit headers at all, so throttle search calls yourself.
How to stay under the HubSpot API rate limits
- Back off on 429. Once you’re over a limit, every call gets a 429. The response’s
policyNamesays whether it was the daily or the burst limit. - Keep errors under 5% of daily requests. HubSpot asks for it, and Marketplace listing requires it.
- Use batch endpoints for reads and writes of many records.
- Throttle search separately at 5 per second, since it has no headers to warn you.
- Budget the daily limit across private apps. Every privately distributed app and service key in the account draws from one shared daily allowance, so one runaway sync can starve the rest. Marketplace OAuth apps are limited per installing account instead.
- Schedule big jobs after the daily reset at midnight in the account’s time zone.
Where Jetstack AI fits
Jetstack AI’s own API has separate, per-key limits: 5 requests per second and 100 per minute, reported in RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset headers, with Retry-After on a 429. See authentication and limits and the developer overview.
Sources
- API usage guidelines and limits (HubSpot Developers)
- CRM search guide (HubSpot Developers)
- Account service keys (HubSpot Developers)
- Set up and use the HubSpot connector for ChatGPT (HubSpot Knowledge Base)
- Authentication and rate limits (Jetstack AI documentation)
Checked October 30, 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