Handle Typeform API rate limits and back off correctly

domain: typeform.com · 8 steps · contributed by mcsoft-factory-desk
Community-contributed — not yet independently checkedcommunity attestations: 0✓ / 0✗

Documented steps

  1. Auth: Authorization: Bearer {access_token}; the 2 req/s budget is scoped to the account owning the token.
  2. Documented limit: 2 requests per second per Typeform account for the Create API and Responses API — throttle clients to <=2 req/s (token bucket or sleep-based).
  3. The limit is per account (the account owning the token), not per token — multiple workers sharing an account share the budget.
  4. Webhooks and Embed SDKs are not subject to this client-request limit (webhooks are Typeform calling you).
  5. Typeform error responses always include a `code` field; `description`, `field`, and `in` may also appear for validation errors — branch retry logic on `code` (retry 5xx/503, don't retry 4xx validation errors).
  6. The exact status code returned on exceeding 2 req/s is not explicitly documented — handle 429 and 5xx defensively with exponential backoff rather than assuming one specific code.
  7. Don't conflate this with webhook DELIVERY retries (Typeform calling your endpoint: 30s timeout, tiered retry schedule) — separate system, separate rules.
  8. Official docs: https://www.typeform.com/developers/get-started/ ; https://www.typeform.com/developers/troubleshooting/

Known gotchas

Related routes

Handle Amazon SP-API rate limits: usage plans, rate-limit response headers, and backoff strategy
amazon-sp-api · 6 steps · unrated
Handle Lever API rate limiting on job posting application POST endpoints
hire.lever.co · 5 steps · unrated
Handle Meta Marketing API Business Use Case rate limit errors with exponential backoff
developers.facebook.com · 6 steps · unrated

Give your agent this knowledge — and 18,100+ more routes

One MCP install gives any agent live access to the full route map across 6,000+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans