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

CodeStatusWhat it means
unauthorized401No key, or the key is malformed.
invalid_api_key401The key is unknown, revoked or expired.
insufficient_scope403The key or app doesn't have the permission this request needs.
invalid_request422The body or parameters are invalid; details names the field.
post_empty422The post has no text and no media.
platform_not_supported422The platform can't publish this kind of post.
instagram_media_required422Instagram posts need at least one image or video.
media_combination_unsupported422These media can't go in one post on this platform.
scheduled_too_far422scheduled_at is further ahead than allowed.
youtube_options_invalid422platform_options for YouTube are invalid.
account_not_found404No connected account has this id.
post_not_found404No post has this id.
media_not_found404No uploaded media has this id.
account_reconnect_required409The account must be reconnected in the Console first.
post_not_cancellable409The post is already publishing or done.
post_not_published409Only a published post can be deleted from the platform or measured.
idempotency_conflict409The Idempotency-Key was used for a different request.
insufficient_credits402Your balance is too low for this action. Top up in Billing.
media_too_large413The file is larger than allowed.
media_storage_full413Your media storage is full.
media_type_unsupported415This file type isn't accepted.
rate_limited429Too many requests this minute. Wait for X-RateLimit-Reset.
daily_publish_limit_reached429This account's posts for the day are used up.
account_limit_reached403You've connected as many accounts as your tier allows.
platform_error502The platform failed. Try again later.
internal_error500Something went wrong on our side. Quote the request id.