Help for owners
My integration says the HubSpot API limit has been reached
Short answer
HubSpot limits how many calls an app may make in each ten-second burst and per day, and answers every call over the limit with a 429 error. The daily allowance is shared by all private apps in the account, so one chatty sync can starve the others. Slow the calls down; do not retry harder.
Does this sound like your situation?
- The integration log shows 429 or RATE_LIMIT errors.
- New leads from my website stopped appearing in HubSpot in the afternoon.
- It works in the morning and fails later in the day.
- It began when I added another connected tool or ran a big import.
- Retrying only makes the errors last longer.
Why does this happen?
There are two limits, a burst limit and a daily limit
For privately distributed apps HubSpot sets a burst limit per ten seconds for each app and a daily limit per account. The numbers depend on the account tier and on any API limit increase, so check HubSpot's table for your tier. Once an app exceeds its limit, every following call gets a 429.
Confirmed by developers.hubspot.com
The daily allowance is shared
HubSpot states that the daily limit is shared by all private apps in the account, while the burst limit applies to each app on its own. A second tool, a reporting sync or a one-off import can use up what the website integration needs.
Confirmed by developers.hubspot.com
The error says which limit it was
The 429 response carries a message and a policy name that show whether the daily or the short-term limit was hit. The daily limit resets at midnight in the account's time zone.
Confirmed by developers.hubspot.com
One call per record and retries on top
An integration that makes several calls for each contact, deal or order, then retries failures immediately, multiplies its own traffic. HubSpot also says error responses should stay under 5 percent of daily requests.
Confirmed by developers.hubspot.comTechnical detail: The OpenAI API answers 429: out of credit, or just too fast?
What can I do about it today?
- Do not keep pressing retry or re-run the syncEvery attempt counts against the same allowance. One attempt after a pause is enough.
- Write down when the errors startedNote the time, and what ran just before: an import, a campaign, a new connected app, a bulk update.
- List every tool connected to your HubSpotIn your account's connected apps and integrations settings. They may all be spending the same daily allowance.
- Pause big one-off jobsAsk whoever runs an import or an export to do it outside business hours or in smaller parts.
- Send your developer the error textThe 429 message, its policy name and the time. It tells them which limit it was.
When should I bring someone in?
- Leads or deals are missing from HubSpot because calls were refused.
- The errors return every day even without an import.
- You are unsure which of your connected tools is using the allowance.
How do I handle it?
- Read the current limits and the responseI read HubSpot's documentation for your account type and look at which limit the errors name and at what time of day they appear.
- Count the calls per recordFrom the logs I find the step that uses most of the allowance and which tool it belongs to.
- Group, cache and paceLookups are cached, records are sent in groups where HubSpot allows it, and a queue waits and slows down when the limit is reached instead of retrying at once.
- Alert before it blocksA message reaches you when the queue grows, so failures do not lose leads silently.
The price depends on what I find, so I quote in writing after a short discovery call. Tell me what is happening and I reply within 24 hours.
What do owners ask about this?
Are the refused requests lost?
The refused call did not run. The data is lost only if your integration drops it after the error, which is why a queue that holds and retries later matters.
Can I buy a higher limit?
HubSpot's documentation describes an API limit increase for accounts, with its own numbers. Check the current terms there; reducing and spacing the calls is usually the first fix.
Does HubSpot's limit apply to forms on my website?
The usage page covers API calls from apps. If forms send data through the API, check the forms documentation for the limits of that endpoint.
Sources
How was this page made?
I drafted this page with AI assistance from the official documents listed under Sources. Found a mistake? Tell me.