Instagram error 4: Application request limit reached

Code 4 is app-level throttling: your application, across every account and endpoint it touches, has exceeded the call volume Meta allows it in the current window. The rate-limiting reference describes it as "the app whose token is being used in the request has reached its rate limit" and the prescribed recovery is to "wait and retry the operation, or examine your API request volume."

For Instagram messaging apps, code 4 usually means the aggregate of everything the app does - sends, conversation reads, profile fetches, comment moderation - not one hot conversation. The documented messaging ceilings are generous for sending (100 calls per second per Instagram professional account for text) but very tight for reading: the Conversations API allows 2 calls per second per account. An app that re-reads a thread on every inbound webhook event will burn its budget at trivial scale, which is the classic path to code 4 during a busy moment such as a giveaway post driving thousands of DMs.

The response headers tell you where you stand before the error does: X-App-Usage reports call count, CPU time and total time as percentages of your limit, and X-Business-Use-Case-Usage adds estimated_time_to_regain_access once you are blocked. Distinguish code 4 from 32 (Pages-API scoped), 17 (user-scoped) and 613/2534040 (the Instagram messaging custom limit).

{
  "error": {
    "message": "(#4) Application request limit reached",
    "type": "OAuthException",
    "code": 4,
    "fbtrace_id": "Kp8qR3sT6uVw"
  }
}

Budget API calls per inbound message at design time - one send, zero reads is achievable for most bots - and enforce it with a client-side rate limiter per account and per app. Cache anything you fetch (user profiles, conversation metadata) with a TTL. Every documented Instagram ceiling, including the per-second Send API and Conversations API numbers and the platform formula, is tabulated in the Instagram limits reference; the back-off pattern is covered in the troubleshooting guide.