instantly-rate-limits

# Instantly Rate Limits ## Overview Handle Instantly API v2 rate limits. The API returns `429 Too Many Requests` when limits are exceeded. Most endpoints follow standard limits. The email listing endpoint has a stricter constraint of **20 requests per minute**. Failed webhook deliveries are retried up to **3 times within 30 seconds**. ## Prerequisites - Completed `instantly-install-auth` setup - Understanding of exponential backoff patterns ## Known Rate Limits | Endpoint | Limit | Notes | |----------|-------|-------| | Most API endpoints | Standard REST limits | Varies by plan | | `GET /emails` | 20 req/min | Stricter — email listing | | Webhook deliveries | 3 retries in 30s | Instantly retries to your endpoint | | Background jobs | N/A | Async — poll via `GET /background-jobs/{id}` | ## Instructions ### Step 1: Exponential Backoff with Jitter ```typescript import { InstantlyApiError } from "./src/instantly/client"; interface RetryOptions { maxRetries: number; baseDelayMs: number; maxDelayMs: number; } const DEFAULT_RETRY: RetryOptions = { maxRetries: 5, baseDelayMs: 1000, maxDelayMs: 30000, }; async function withBackoff<T>( operation: () => Promise<T>, opts: Partial<RetryOptions> = {} ): Promise<T> { const { maxRetries, baseDelayMs, maxDelayMs } = { ...DEFAULT_RETRY, ...opts }; for (let attempt = 0; attempt <= maxRetries; attempt++) { try { return await operation(); } catch (err) { const isRetryable = err instanceof ...