HubSpot

CRM MCP Server for Cloudflare Workers

Rate Limits & Quotas

Understand the rate limits and quotas for HubSpot API access.

Requests / Minute

432,000

Requests / Day

Important Notes

•HubSpot API rate limits vary by endpoint and tier
•Standard tier (most common): 10 requests per second per endpoint
•Daily limit: 432,000 requests per day (10 req/s × 60s × 60m × 12h average)
•Some endpoints have different limits - CRM objects typically allow 100 requests per 10 seconds
•Rate limits are enforced per API key and per authenticated user
•Exceeding limits returns 429 (Too Many Requests) status code
•HubSpot recommends implementing exponential backoff for retry logic
•Check specific endpoint documentation as limits may vary by API version and product

Best Practices

Tips to avoid hitting rate limits

1.
Implement exponential backoff
When you receive a 429 error, wait before retrying with increasing delays.
2.
Cache responses when possible
Store frequently accessed data locally to reduce API calls.
3.
Use batch operations
Combine multiple operations into single requests where supported.
4.
Monitor your usage
Use the Primrose dashboard to track your API usage and set alerts.

Rate Limit Errors

What happens when you exceed limits

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests",
    "retry_after": 60
  }
}

When rate limited, the response includes a retry_after value indicating how many seconds to wait before retrying.