Skip to content

Rate Limiting

The package includes automatic rate limiting via Saloon's rate limit plugin backed by Laravel's cache. When the limit is reached, requests will automatically sleep until the next window opens.

Configure your rate limits based on your HubSpot subscription tier:

ini
# Free/Starter plans
HUBSPOT_RATE_LIMIT_REQUESTS=100
HUBSPOT_RATE_LIMIT_PER_SECONDS=10

# Professional/Enterprise plans
HUBSPOT_RATE_LIMIT_REQUESTS=150
HUBSPOT_RATE_LIMIT_PER_SECONDS=10

HubSpot enforces different rate limits depending on your subscription:

  • Free/Starter plans are limited to 100 requests per 10 seconds.
  • Professional/Enterprise plans are limited to 150 requests per 10 seconds.

Set HUBSPOT_RATE_LIMIT_REQUESTS and HUBSPOT_RATE_LIMIT_PER_SECONDS in your .env file to match your plan. The package will handle the rest, automatically pausing outgoing requests when the limit is about to be exceeded.