Rate limiting approach

Hi,

I’m working with your API and have a question about rate limiting. We see occasional rate limit errors in our application. Could you please clarify how exactly your rate limiting works? Specifically:

  • Do you use a fixed 1-second window or a sliding window approach?
  • How do you count requests within the window?
  • Is there any buffer time between windows?

This will help us better adjust our application to work with your API.

Thank you!

Hi,
Hubspot uses a sliding window approach for rate limiting, rather than sticking to a fixed 1-second window. It counts requests based on the limits shown in headers like X-HubSpot-RateLimit-Max and X-HubSpot-RateLimit-Remaining. There’s no specific buffer time between windows…it’s more of a rolling interval which is indicated by the X-HubSpot-RateLimit-Interval-Milliseconds header

Cheers,

Harsh

Fario Consulting

Hi, Harsh.
Thanks a lot for such detailed answer.