intercom-rate-limits

# Intercom Rate Limits ## Overview Intercom enforces rate limits per app and per workspace. Handle 429 errors gracefully with exponential backoff, queue-based throttling, and proactive header monitoring. ## Rate Limit Tiers | Scope | Limit | Notes | |-------|-------|-------| | Private app | 10,000 req/min | Per app | | Public app (OAuth) | 10,000 req/min | Per app | | Workspace total | 25,000 req/min | Across all apps | | Search endpoints | 1,000 req/min | `/contacts/search`, `/conversations/search` | | Scroll endpoints | 100 req/min | Bulk data export | ## Rate Limit Headers Every response includes these headers: ``` X-RateLimit-Limit: 10000 # Max requests per window X-RateLimit-Remaining: 9847 # Remaining requests X-RateLimit-Reset: 1711100060 # Unix timestamp when window resets ``` ## Instructions ### Step 1: Exponential Backoff with Header Awareness ```typescript import { IntercomClient, IntercomError } from "intercom-client"; async function withRateLimitRetry<T>( operation: () => Promise<T>, config = { maxRetries: 5, baseDelayMs: 1000, maxDelayMs: 60000 } ): Promise<T> { for (let attempt = 0; attempt <= config.maxRetries; attempt++) { try { return await operation(); } catch (err) { if (!(err instanceof IntercomError)) throw err; if (err.statusCode !== 429 && (err.statusCode ?? 0) < 500) throw err; if (attempt === config.maxRetries) throw err; let delayMs: number; if (err.statusCode === 429) { ...