Skip to main content
MCP tool calls count against the first three limits too. The send_invoice tool uses the 10-per-hour bucket for confirmed sends; its preview call (no confirmation_token) only counts as an ordinary request. Over the 300-per-minute MCP limit, /mcp answers 429 with Retry-After. With OAuth, “API key” means the connected app. Every authenticated response includes these headers for the key’s bucket:

Handle a 429

Over a limit, you get 429 rate_limited with a Retry-After header in seconds. Wait that long, then retry with the same Idempotency-Key.
The SDKs wait and retry automatically when Retry-After is 60 seconds or less. For longer waits they raise RateLimitError with retryAfter (Node.js) or retry_after (Python).

Stay under the limits

  • Use limit=100 on list endpoints.
  • Use webhooks or the GET /invoices?status=... filters instead of polling single invoices.
  • Spread large email batches over several hours.