Errors
Every error has the same shape, a stable code to act on, and a request id to quote when you contact us.
Error body
{
"error": {
"code": "insufficient_credits",
"message": "Balance too low for post.video",
"request_id": "req_8d2f61c04b7e4a19a3f5",
"details": {}
}
}Codes
| Code | Status | What it means |
|---|---|---|
| unauthorized | 401 | No key, or the key is malformed. |
| invalid_api_key | 401 | The key is unknown, revoked or expired. |
| insufficient_scope | 403 | The key or app doesn't have the permission this request needs. |
| invalid_request | 422 | The body or parameters are invalid; details names the field. |
| post_empty | 422 | The post has no text and no media. |
| platform_not_supported | 422 | The platform can't publish this kind of post. |
| instagram_media_required | 422 | Instagram posts need at least one image or video. |
| media_combination_unsupported | 422 | These media can't go in one post on this platform. |
| scheduled_too_far | 422 | scheduled_at is further ahead than allowed. |
| youtube_options_invalid | 422 | platform_options for YouTube are invalid. |
| account_not_found | 404 | No connected account has this id. |
| post_not_found | 404 | No post has this id. |
| media_not_found | 404 | No uploaded media has this id. |
| account_reconnect_required | 409 | The account must be reconnected in the Console first. |
| post_not_cancellable | 409 | The post is already publishing or done. |
| post_not_published | 409 | Only a published post can be deleted from the platform or measured. |
| idempotency_conflict | 409 | The Idempotency-Key was used for a different request. |
| insufficient_credits | 402 | Your balance is too low for this action. Top up in Billing. |
| media_too_large | 413 | The file is larger than allowed. |
| media_storage_full | 413 | Your media storage is full. |
| media_type_unsupported | 415 | This file type isn't accepted. |
| rate_limited | 429 | Too many requests this minute. Wait for X-RateLimit-Reset. |
| daily_publish_limit_reached | 429 | This account's posts for the day are used up. |
| account_limit_reached | 403 | You've connected as many accounts as your tier allows. |
| platform_error | 502 | The platform failed. Try again later. |
| internal_error | 500 | Something went wrong on our side. Quote the request id. |