We standardized errors across all platforms. Whether it’s TikTok rejecting your music or Instagram hating your aspect ratio, you get a clean JSON response.
The Error Object
Look for errorsVerbose in the response.
{
"errorsVerbose": {
"INSTAGRAM": {
"code": "META:190",
"userFacingMessage": "Your Instagram token expired. Please reconnect.",
"isTransient": false
},
"TIKTOK": null // Success!
}
}
Key Fields
| Field | Meaning |
|---|
code | Stable ID (e.g. HTTP:429). Use this for logic. |
userFacingMessage | Safe to show your users. “Please reconnect.” |
errorMessage | Raw developer logs. “OAuthException: Validate permission failed.” |
isTransient | true = Retry later. false = Give up / Fix input. |
Common Error Prefixes
| Prefix | Platform |
|---|
META | Instagram, Facebook, Threads |
TT | TikTok |
LI | LinkedIn |
YT | YouTube |
HTTP | Generic API errors |
Transient vs. Non-Transient
- Transient (
true): Rate limits, server timeouts. Action: Retry with exponential backoff.
- Non-Transient (
false): Auth errors, validation errors. Action: Ask user to fix it (reconnect account, change video file).
Support: If you see a weird error code, send us the meta field. We trace it.
