hubspot-rate-limits

# HubSpot Rate Limits ## Overview Handle HubSpot API rate limits with proper backoff strategies. HubSpot enforces per-second and daily limits shared across all apps in a portal. ## Prerequisites - `@hubspot/api-client` installed - Understanding of HubSpot's shared rate limit model ## Instructions ### Step 1: Understand HubSpot Rate Limit Tiers | Plan | Per-Second Limit | Daily Limit | Burst | |------|-----------------|-------------|-------| | Free/Starter | 10 requests/sec | 250,000/day | -- | | Professional | 10 requests/sec | 500,000/day | -- | | Enterprise | 10 requests/sec | 500,000/day | -- | | API Add-on | 10 requests/sec | 1,000,000/day | -- | **Critical:** Limits are per HubSpot portal (account), not per app. All private apps and OAuth apps in the same portal share the same limit bucket. ### Step 2: Use SDK Built-in Retries ```typescript import * as hubspot from '@hubspot/api-client'; // The SDK has built-in retry for 429 responses const client = new hubspot.Client({ accessToken: process.env.HUBSPOT_ACCESS_TOKEN!, numberOfApiCallRetries: 3, // retries 429 and 5xx automatically }); ``` ### Step 3: Custom Backoff with Retry-After Header ```typescript async function withHubSpotBackoff<T>( operation: () => Promise<T>, config = { maxRetries: 5, baseDelayMs: 1000, maxDelayMs: 30000 } ): Promise<T> { for (let attempt = 0; attempt <= config.maxRetries; attempt++) { try { return await operation(); } catch (error: any) { if (attempt ==...