API Errors

Errors use a consistent JSON body. Successful responses return the resource directly (or a wrapper like { "accounts": [...] }).

Error body

{
  "error": {
    "code": "validation_error",
    "message": "scheduled_at must be in the future"
  }
}

HTTP	code	When
HTTP	code	When
401	`unauthorized`	Missing, invalid, or revoked API key.
403	`forbidden`	Free plan, posting disabled on the account, or updating/deleting a posted post.
404	`not_found`	Account or post does not exist (or is not yours / not API-created).
422	`validation_error`	Invalid JSON, past scheduled_at, bad media, or invalid auto-retweet hours.
422	`rate_limit_exceeded`	Daily post cap reached for that account (7 scheduled + posted posts that day).
422	`insufficient_credits`	Not enough credits to publish (1 per post, plus 2 if the post contains a URL).
500	`post_failed`	Publish-now succeeded locally but the social network did not return a post id.
500	`internal_error`	Unexpected server error.