Gorgias API rate limits: OAuth vs API key budgets and the limit headers

TL;DR

If you poll Gorgias heavily, prefer OAuth for the doubled budget, watch the rate-limit headers on every response, and when you get a 429, wait for the Retry-after duration instead of hammering retries. Design sync jobs to stay under 40 requests per 20 seconds if they must use an API key.

Fix

1. If you poll Gorgias heavily, prefer OAuth for the doubled budget, watch the rate-limit headers on every response, and when you get a 429, wait for the Retry-after duration instead of hammering retries. Expected: You get the expected result; the problem is gone.

When to use

• You are setting up or using this Gorgias API rate limits feature.
• The symptom matches: OAuth vs API key budgets and the limit headers.

When NOT to use

• Unrelated Gorgias API rate limits issues (different feature, different failure).
• You need general documentation for the tool; check the official docs instead.

Compatibility

Reported against Gorgias API rate limits.

Variant phrasings

OAuth vs API key budgets and the limit headers

Why it happens

Per the Gorgias docs, OAuth apps get 80 requests per 20 seconds and API key apps get 40 requests per 20 seconds. The response headers tell you where you stand, including X-Gorgias-Account-Api-Call-Limit.

Edge cases

• If your error message differs even slightly, this is probably a different issue; search the exact text.
• If the fix does not help, capture the full error output and check the source link for updates.

Per the Gorgias docs, OAuth apps get 80 requests per 20 seconds and API key apps get 40 requests per 20 seconds. The response headers tell you where you stand, including X-Gorgias-Account-Api-Call-Limit. Resolved: If you poll Gorgias heavily, prefer OAuth for the doubled budget, watch the rate-limit headers on every response, and when you get a 429, wait for the Retry-after duration instead of hammering retries. Design sync jobs to stay under 40 requests per 20 seconds if they must use an API key. Source: https://developers.gorgias.com/api/rate-limits