Graph API error codes
Errors use a Meta-compatible JSON shape:
{
"error": {
"message": "Human-readable detail",
"type": "GraphException",
"code": 400,
"error_subcode": 458,
"fbtrace_id": "aura_..."
}
}
Common subcodes
| Subcode | Meaning |
|---|---|
| 458 | Insufficient scope — request additional permissions or App Review |
| 613 | Rate limit — back off and respect Retry-After |
| 620 | Marketing API tier restriction |
| 630 | Live mode required — app is in Development mode |
| 803 | Asset not found or not accessible with this token |
| 840 | Messenger handover invalid state |
Debugging
- Note
fbtrace_idwhen contacting support. - Run debug_token on the access token.
- Reproduce in Graph Explorer with the same node and fields.
Full table: /developers/reference#errors.