Error codes
Branch on error_code, never on the text of message or error: the code is a stable contract and is never renamed or reused; the text can change at any time. New codes are added over time, so treat an unknown code like the HTTP status it came with.
Some older endpoints name the same field reason (webhook deliveries and subscriptions), code (Facebook Page info) or error_type (post analytics). Endpoints without a code answer only message or error.
Why an upload failed
Each platform result of a failed upload carries one of these in error_code (status, history and the upload_completed webhook).
| error_code | What happened | What to do |
|---|---|---|
account_blocked | A scheduled post was not sent because the account is blocked. | Contact support. |
account_checkpoint_required | The platform put the account behind a security checkpoint. | Log in on the platform and clear the checkpoint, then retry. |
account_pending_deletion | A scheduled post was not sent because the account is waiting to be deleted. | Restore the account to publish again. |
account_permission_denied | The connection lacks a permission the post needs. | Reconnect granting every requested permission. |
account_reauth_required | The platform no longer accepts the connection (token expired or revoked). | Reconnect the account; retrying without reconnecting fails again. |
account_restricted | The platform restricted the account (spam or policy). | Resolve it on the platform; Upload-Post stops posting to it meanwhile. |
config_target_missing | The connection works but the target (Page, board, location, chat...) is missing or wrong. | Select or fix the target, then retry. |
content_duplicate | The platform rejected the post as a duplicate. | Change the content. |
content_rejected | The platform rejected the content. | Change the content. |
cost_cap_reached | A per-account spending cap for this platform was reached. | Retry later. |
daily_cap_reached | The profile used its posts for the last 24 hours on that platform. | Retry later or schedule the post. |
instagram_publishing_limit_reached | Instagram's 24-hour publishing quota of the account is used up; nothing was sent. | Check GET /uploadposts/instagram/publishing_limit and retry later. |
media_download_failed | Upload-Post could not download the media URL. | Check the URL is public and retry. |
media_invalid_format | The media does not meet the platform's requirements. | Fix the file (see the media requirements pages). |
monthly_limit_reached | The account's monthly upload allowance is used up. | Upgrade the plan or wait for the next period. |
platform_integration_paused | Upload-Post paused publishing to this platform for a while. | Retry later. |
platform_rate_limited | The platform asked us to slow down. | Retry later. |
platform_unavailable | The platform failed or timed out. | Retry later. |
profile_blocked_by_plan | A scheduled post was not sent because its profile is not available on the account's current plan. | Upgrade the plan, or schedule the post on a profile the plan includes. |
profile_not_found | A scheduled post was not sent because its profile no longer exists. | Schedule the post again on an existing profile (GET /uploadposts/users lists them). |
reached_active_user_cap | TikTok's daily active-user quota for the app is used up (TikTok's own code). | Retry tomorrow. |
telegram_paid_broadcast_not_allowed | Telegram refused a post sent with telegram_allow_paid_broadcast: paid broadcasts need at least 100,000 Telegram Stars on the bot's balance and 100,000 monthly active users. Nothing was sent. | Send the post again without telegram_allow_paid_broadcast. |
tiktok_media_rejected | TikTok accepted the job and then rejected the media (format, duration, frame rate...). | Fix the video and post again. |
tiktok_privacy_unavailable | The TikTok account cannot publish with the requested privacy level. | Use one of the levels GET /uploadposts/tiktok/settings returns. |
tiktok_publish_failed | TikTok accepted the job and then failed to publish it. | Retry. |
unknown_error | Not classified. | Read the error message; contact support if it repeats. |
upload_interrupted | The upload was interrupted while the platform was receiving it: it may or may not have been published. | Check the account before posting again. |
x_unknown_outcome | The post was sent to X but X did not confirm whether it was created: it may already be published. Upload-Post never re-sends it. | Check the X account before posting again, or it could be posted twice. |
youtube_api_quota_exceeded | The YouTube API quota for today is used up. | Retry after midnight Pacific Time. |
youtube_channel_daily_limit | YouTube refused more uploads today for this channel. | Retry tomorrow. |
Errors of a request
What an endpoint answers when it refuses a request (240 codes). The full detail of each one is in the OpenAPI spec of the endpoint.
| error_code | HTTP | Meaning | Returned by |
|---|---|---|---|
account_name_required | 400 | Invalid request, or Google rejected it. | PATCH /api/uploadposts/google-business/accounts, POST /api/uploadposts/google-business/accounts |
account_not_found | 404 | Not found. | DELETE /api/uploadposts/google-business/admins, GET /api/uploadposts/google-business/accounts/get, GET /api/uploadposts/google-business/admins and 4 more |
account_required | 400 | Invalid request, or Google rejected it. | GET /api/uploadposts/google-business/accounts/get, GET /api/uploadposts/google-business/food-menus, GET /api/uploadposts/google-business/google-locations/recommended and 10 more |
account_unavailable | 403 | The token or the profile does not allow client approval, or the account is unavailable. | GET /api/uploadposts/approvals/client, POST /api/uploadposts/approvals/client/{approval_id}/approve, POST /api/uploadposts/approvals/client/{approval_id}/reject |
admin_not_found | 404 | Not found. | DELETE /api/uploadposts/google-business/admins, PATCH /api/uploadposts/google-business/admins |
admin_required | 400 | Invalid request, or Google rejected it. | POST /api/uploadposts/google-business/admins |
already_reposted | 409 | Threads: already reposted. | POST /api/uploadposts/posts/repost |
approval_closed | 409 | Already closed. | DELETE /api/uploadposts/approvals/{approval_id}, PATCH /api/uploadposts/approvals/{approval_id}, POST /api/uploadposts/approvals/client/{approval_id}/approve and 3 more |
approval_expired | 409 | Already closed; reviewed version is outdated (current_version and item included); an Editor's post whose date already passed (it becomes expired); a draft proposing a past date; changed meanwhile; or no free queue slot. | POST /api/uploadposts/approvals/client/{approval_id}/approve, POST /api/uploadposts/approvals/{approval_id}/approve |
approval_failed | 500 | The job could not be created. | POST /api/uploadposts/approvals/client/{approval_id}/approve, POST /api/uploadposts/approvals/{approval_id}/approve |
approval_not_found | 404 | Not found. | DELETE /api/uploadposts/approvals/{approval_id}, GET /api/uploadposts/approvals/{approval_id}, PATCH /api/uploadposts/approvals/{approval_id} and 4 more |
approval_state_changed | 409 | Already decided, or changed meanwhile. | PATCH /api/uploadposts/approvals/{approval_id}, POST /api/uploadposts/approvals/client/{approval_id}/approve, POST /api/uploadposts/approvals/{approval_id}/approve |
approval_version_changed | 409 | Already closed; reviewed version is outdated (current_version and item included); an Editor's post whose date already passed (it becomes expired); a draft proposing a past date; changed meanwhile; or no free queue slot. | POST /api/uploadposts/approvals/client/{approval_id}/approve, POST /api/uploadposts/approvals/{approval_id}/approve |
audit_unavailable | 503 | Temporarily unavailable; nothing was sent to Google. | DELETE /api/uploadposts/google-business/admins, PATCH /api/uploadposts/google-business/accounts, PATCH /api/uploadposts/google-business/admins and 5 more |
blocked_url | 409 | The subscription is disabled, or its URL is not an allowed destination. | POST /api/uploadposts/webhooks/deliveries/{delivery_id}/redeliver, POST /api/uploadposts/webhooks/subscriptions/{subscription_id}/test |
bluesky_blocked | 403 | The connected account lacks the required scope (e.g. YouTube not connected with youtube.force-ssl). LinkedIn replies (comment_id): (personal-profile connection) or linkedin_page_access_denied (Page connection LinkedIn refused); the top-level LinkedIn listing passes LinkedIn's own 403 through. Bluesky thread view: (a block between the account and the post's author). | GET /api/uploadposts/comments |
bluesky_daily_interaction_limit | 429 | Daily limit. | POST /api/uploadposts/posts/repost |
bluesky_feature_disabled | 503 | Bluesky reposts not available yet. | POST /api/uploadposts/posts/action, POST /api/uploadposts/posts/repost |
bluesky_invalid_parameter | 400 | Missing or invalid parameters, platform account not linked, or a cursor was supplied for LinkedIn, Discord or Telegram (which do not support cursors). Bluesky: for a wrong filter or include_pins. | GET /api/uploadposts/bluesky/xrpc/{nsid}, GET /api/uploadposts/media |
bluesky_not_found | 404 | (Instagram/Facebook do not know the comment_id) or linkedin_comment_not_found (a bare LinkedIn comment_id not among the post's first 250 comments; pass the comment_urn). Bluesky thread view: (Bluesky cannot find the post or reply). | GET /api/uploadposts/comments |
bluesky_send_unconfirmed | 504 | — | POST /api/uploadposts/dms/send |
category_required | 400 | Invalid request, or Google rejected it. | PATCH /api/uploadposts/google-business/media |
client_approval_not_allowed | 403 | The token or the profile does not allow client approval, or the account is unavailable. | GET /api/uploadposts/approvals/client, POST /api/uploadposts/approvals/client/{approval_id}/approve, POST /api/uploadposts/approvals/client/{approval_id}/reject |
comment_not_found | 404 | (Instagram/Facebook do not know the comment_id) or linkedin_comment_not_found (a bare LinkedIn comment_id not among the post's first 250 comments; pass the comment_urn). Bluesky thread view: (Bluesky cannot find the post or reply). | GET /api/uploadposts/comments |
comment_required | 400 | Missing or invalid comment. | POST /api/uploadposts/approvals/client/{approval_id}/reject, POST /api/uploadposts/approvals/{approval_id}/reject |
commercial_disclosure_invalid_value | 400 | Missing fields, nothing to update, unsupported platform or invalid value. | POST /api/uploadposts/posts/edit |
confirmation_required | 400 | Invalid request, or Google rejected it. | DELETE /api/uploadposts/google-business/admins, DELETE /api/uploadposts/google-business/locations/delete, DELETE /api/uploadposts/google-business/media and 23 more |
conflicting_verification_inputs | 400 | Invalid request, or Google rejected it. | POST /api/uploadposts/google-business/verification/start |
connected_identity | 409 | Conflict. | DELETE /api/uploadposts/google-business/admins, PATCH /api/uploadposts/google-business/admins |
daily_limit | 429 | X daily limit (limit, retry_after). | GET /api/uploadposts/post-analytics |
daily_limit_reached | 429 | Rate or daily limit reached; retry after retry_after_seconds when present. | DELETE /api/uploadposts/google-business/admins, DELETE /api/uploadposts/google-business/locations/delete, DELETE /api/uploadposts/google-business/media and 63 more |
delivery_log_disabled | 503 | Redelivery temporarily disabled, or webhook subscriptions switched off for a delivery of a subscription. | POST /api/uploadposts/webhooks/deliveries/{delivery_id}/redeliver |
elaboration_required | 400 | Invalid request, or Google rejected it. | POST /api/uploadposts/google-business/google-locations/report |
event_unsubscribed | 409 | Nowhere to send it, or it cannot be sent again (a removed webhook or subscription, a disabled subscription, a blocked URL or a real-time event that is not kept). | POST /api/uploadposts/webhooks/deliveries/{delivery_id}/redeliver |
facebook_api_error | 502 | Error on Facebook's side. | GET /api/uploadposts/facebook/page-info, PATCH /api/uploadposts/facebook/page-info |
facebook_not_connected | 400 | Invalid request. | GET /api/uploadposts/facebook/page-info, PATCH /api/uploadposts/facebook/page-info |
facebook_page_not_accessible | 400 | Invalid request. | GET /api/uploadposts/facebook/page-info, PATCH /api/uploadposts/facebook/page-info |
facebook_page_required | 400 | Invalid request. | GET /api/uploadposts/facebook/page-info, PATCH /api/uploadposts/facebook/page-info |
facebook_permission_denied | 403 | The account lacks a permission to list its Pages. | GET /api/uploadposts/users/facebook-page |
facebook_permission_missing | 403 | Meta requires pages_manage_metadata (pending App Review). | PATCH /api/uploadposts/facebook/page-info |
facebook_reauth_required | 401 | Facebook session expired or revoked (reauth_required: true). | GET /api/uploadposts/users/facebook-page |
facebook_reconnect_required | 401 | Facebook token no longer valid. | GET /api/uploadposts/facebook/page-info, PATCH /api/uploadposts/facebook/page-info |
facebook_validation_error | 400 | Invalid request. | GET /api/uploadposts/facebook/page-info, PATCH /api/uploadposts/facebook/page-info |
FIELD_NOT_EDITABLE | 400 | — | PATCH /api/uploadposts/users/{username} |
food_menus_not_supported | 400 | Invalid request, or Google rejected it. | GET /api/uploadposts/google-business/food-menus, PUT /api/uploadposts/google-business/food-menus |
gbp_feature_disabled | 503 | Temporarily unavailable; nothing was sent to Google. | DELETE /api/uploadposts/google-business/admins, DELETE /api/uploadposts/google-business/locations/delete, DELETE /api/uploadposts/google-business/media and 65 more |
gbp_notifications_unavailable | 503 | Temporarily unavailable; nothing was sent to Google. | GET /api/uploadposts/google-business/notifications, PATCH /api/uploadposts/google-business/notifications, PUT /api/uploadposts/google-business/notifications |
gbp_quota_guard_unavailable | 503 | Temporarily unavailable; nothing was sent to Google. | POST /api/uploadposts/google-business/google-locations/search, POST /api/uploadposts/google-business/locations/create, POST /api/uploadposts/google-business/verification/complete and 1 more |
google_api_error | 502 | Google failed, could not be reached, or did not confirm the result. | DELETE /api/uploadposts/google-business/admins, DELETE /api/uploadposts/google-business/locations/delete, DELETE /api/uploadposts/google-business/media and 72 more |
google_business_not_connected | 400 | Invalid request, or Google rejected it. | DELETE /api/uploadposts/google-business/admins, DELETE /api/uploadposts/google-business/locations/delete, DELETE /api/uploadposts/google-business/media and 66 more |
google_daily_quota_exhausted | 429 | Rate or daily limit reached; retry after retry_after_seconds when present. | GET /api/uploadposts/google-business/posts, GET /api/uploadposts/google-business/posts/get, POST /api/uploadposts/google-business/google-locations/search and 1 more |
google_rate_limited | 429 | Rate or daily limit reached; retry after retry_after_seconds when present. | DELETE /api/uploadposts/google-business/admins, DELETE /api/uploadposts/google-business/locations/delete, DELETE /api/uploadposts/google-business/media and 72 more |
google_result_unknown | 502 | Google failed, could not be reached, or did not confirm the result. | DELETE /api/uploadposts/google-business/admins, DELETE /api/uploadposts/google-business/locations/delete, DELETE /api/uploadposts/google-business/media and 26 more |
google_unreachable | 502 | Google failed, could not be reached, or did not confirm the result. | DELETE /api/uploadposts/google-business/admins, DELETE /api/uploadposts/google-business/locations/delete, DELETE /api/uploadposts/google-business/media and 72 more |
identity_check_unavailable | 503 | Temporarily unavailable; nothing was sent to Google. | DELETE /api/uploadposts/google-business/admins, PATCH /api/uploadposts/google-business/admins |
invalid_account | 400 | Invalid request, or Google rejected it. | GET /api/uploadposts/google-business/accounts, GET /api/uploadposts/google-business/accounts/get, GET /api/uploadposts/google-business/google-locations/recommended and 10 more |
invalid_account_type | 400 | Invalid request, or Google rejected it. | GET /api/uploadposts/google-business/accounts, POST /api/uploadposts/google-business/accounts |
invalid_action | 400 | Invalid filter. | GET /api/uploadposts/teams/audit |
invalid_actor | 400 | Invalid filter. | GET /api/uploadposts/teams/audit |
invalid_admin | 400 | Invalid request, or Google rejected it. | POST /api/uploadposts/google-business/admins |
invalid_admin_name | 400 | Invalid request, or Google rejected it. | DELETE /api/uploadposts/google-business/admins, PATCH /api/uploadposts/google-business/admins |
invalid_api | 400 | Invalid request, or Google rejected it. | GET /api/uploadposts/google-business/services, PUT /api/uploadposts/google-business/services |
invalid_before | 400 | Invalid filter. | GET /api/uploadposts/approvals |
invalid_body | 400 | Invalid body. | PATCH /api/uploadposts/approvals/{approval_id}, POST /api/uploadposts/approvals/{approval_id}/approve, POST /api/uploadposts/webhooks/subscriptions |
invalid_breakdown | 400 | Invalid request, or Google rejected it. | GET /api/uploadposts/google-business/performance |
invalid_category | 400 | Invalid request, or Google rejected it. | GET /api/uploadposts/google-business/attributes/available |
invalid_chain | 400 | Invalid request, or Google rejected it. | GET /api/uploadposts/google-business/chains/get |
invalid_chain_name | 400 | Invalid request, or Google rejected it. | GET /api/uploadposts/google-business/chains |
invalid_client_approval | 400 | Missing username, or an invalid connect_theme, ui_labels, client_approval (true or false; checked while post approvals are on) or preserve_settings. | POST /api/uploadposts/users/generate-jwt |
invalid_comment | 400 | Invalid body. | POST /api/uploadposts/approvals/client/{approval_id}/approve, POST /api/uploadposts/approvals/client/{approval_id}/reject, POST /api/uploadposts/approvals/{approval_id}/approve and 3 more |
invalid_comment_id | 400 | Missing parameters, invalid post identifier, limit outside 1-50, or an unsupported platform. (comment_id in the wrong format), invalid_post_url (post_id is not a URL or id of a post), invalid_cursor (LinkedIn replies: after is not the number from next_cursor), platform_not_supported (comment_id on a platform without replies). TikTok: (reconnect the account) or invalid_parameter (TikTok error 40002: the request itself is wrong, e.g. a post_id that is not one of the account's videos; do not retry it). | GET /api/uploadposts/comments |
invalid_context | 400 | Invalid request, or Google rejected it. | POST /api/uploadposts/google-business/verification/options, POST /api/uploadposts/google-business/verification/start |
invalid_cursor | 400 | Invalid filter. | GET /api/uploadposts/comments, GET /api/uploadposts/teams/audit |
invalid_date | 400 | Invalid filter. | GET /api/uploadposts/teams/audit |
invalid_date_range | 400 | Invalid request, or Google rejected it. | GET /api/uploadposts/google-business/performance |
invalid_decision | 400 | Invalid request, or Google rejected it. | POST /api/uploadposts/google-business/location-info/google-updates |
invalid_description | 400 | Invalid request, or Google rejected it. | POST /api/uploadposts/google-business/media |
invalid_destination_account | 400 | Invalid request, or Google rejected it. | POST /api/uploadposts/google-business/locations/transfer |
invalid_edit_mode | 400 | Invalid request, or Google rejected it. | PATCH /api/uploadposts/google-business/location-info, POST /api/uploadposts/google-business/location-info |
invalid_elaboration | 400 | Invalid request, or Google rejected it. | POST /api/uploadposts/google-business/google-locations/report |
invalid_email_address | 400 | Invalid request, or Google rejected it. | POST /api/uploadposts/google-business/verification/start |
invalid_event | 400 | event is not one of the subscription's events (allowed_events). | POST /api/uploadposts/webhooks/subscriptions/{subscription_id}/test |
invalid_events | 400 | Invalid request. | POST /api/uploadposts/webhooks/subscriptions |
invalid_field | 400 | Invalid request. | GET /api/uploadposts/facebook/page-info, PATCH /api/uploadposts/facebook/page-info, PATCH /api/uploadposts/google-business/attributes and 8 more |
invalid_fields | 400 | Invalid request, or Google rejected it. | POST /api/uploadposts/google-business/location-info/google-updates |
invalid_filter | 400 | Invalid request, or Google rejected it. | GET /api/uploadposts/google-business/locations/list |
invalid_google_location | 400 | Invalid request, or Google rejected it. | POST /api/uploadposts/google-business/google-locations/report |
invalid_invitation | 400 | Invalid request, or Google rejected it. | POST /api/uploadposts/google-business/invitations/accept, POST /api/uploadposts/google-business/invitations/decline |
invalid_json | 400 | Invalid request, or Google rejected it. | DELETE /api/uploadposts/google-business/admins, DELETE /api/uploadposts/google-business/media, PATCH /api/uploadposts/google-business/accounts and 28 more |
invalid_language_code | 400 | Invalid request, or Google rejected it. | GET /api/uploadposts/google-business/attributes/available, GET /api/uploadposts/google-business/categories, GET /api/uploadposts/google-business/categories/batch and 4 more |
invalid_limit | 400 | Invalid filter. | GET /api/uploadposts/approvals, GET /api/uploadposts/teams/audit |
invalid_link | 400 | Invalid request, or Google rejected it. | DELETE /api/uploadposts/google-business/place-actions, GET /api/uploadposts/google-business/place-actions/get, PATCH /api/uploadposts/google-business/place-actions |
invalid_location_id | 400 | Invalid request, or Google rejected it. | DELETE /api/uploadposts/google-business/admins, DELETE /api/uploadposts/google-business/locations/delete, DELETE /api/uploadposts/google-business/media and 51 more |
invalid_lodging | 400 | Invalid request, or Google rejected it. | PATCH /api/uploadposts/google-business/lodging |
invalid_mailer_contact | 400 | Invalid request, or Google rejected it. | POST /api/uploadposts/google-business/verification/start |
invalid_media_category | 400 | Invalid request, or Google rejected it. | PATCH /api/uploadposts/google-business/media, POST /api/uploadposts/google-business/media |
invalid_media_file | 400 | Invalid request, or Google rejected it. | POST /api/uploadposts/google-business/media |
invalid_media_format | 400 | Invalid request, or Google rejected it. | POST /api/uploadposts/google-business/media |
invalid_media_name | 400 | Invalid request, or Google rejected it. | DELETE /api/uploadposts/google-business/media, GET /api/uploadposts/google-business/media/customers/get, GET /api/uploadposts/google-business/media/get and 1 more |
invalid_media_source | 400 | Invalid request, or Google rejected it. | POST /api/uploadposts/google-business/media |
invalid_menus | 400 | Invalid request, or Google rejected it. | PUT /api/uploadposts/google-business/food-menus |
invalid_metric | 400 | Invalid request, or Google rejected it. | GET /api/uploadposts/google-business/performance |
invalid_month_range | 400 | Invalid request, or Google rejected it. | GET /api/uploadposts/google-business/performance/keywords |
invalid_name | 400 | Invalid request. | POST /api/uploadposts/webhooks/subscriptions |
invalid_names | 400 | Invalid request, or Google rejected it. | GET /api/uploadposts/google-business/categories/batch |
invalid_notification_type | 400 | Invalid request, or Google rejected it. | PATCH /api/uploadposts/google-business/notifications, PUT /api/uploadposts/google-business/notifications |
invalid_order_by | 400 | Invalid request, or Google rejected it. | GET /api/uploadposts/google-business/locations/list |
invalid_page_size | 400 | Invalid request, or Google rejected it. | GET /api/uploadposts/google-business/accounts, GET /api/uploadposts/google-business/attributes/available, GET /api/uploadposts/google-business/categories and 11 more |
invalid_page_token | 400 | Invalid request, or Google rejected it. | GET /api/uploadposts/google-business/accounts, GET /api/uploadposts/google-business/attributes/available, GET /api/uploadposts/google-business/categories and 9 more |
invalid_parameter | 400 | The Facebook Page is not available to the connected account. | GET /api/uploadposts/comments, GET /api/uploadposts/linkedin/resolve-organization, GET /api/uploadposts/users/facebook-page and 3 more |
invalid_phone_number | 400 | Invalid request, or Google rejected it. | POST /api/uploadposts/google-business/verification/start |
invalid_pin | 400 | Invalid request, or Google rejected it. | POST /api/uploadposts/google-business/verification/complete |
invalid_place_action_type | 400 | Invalid request, or Google rejected it. | GET /api/uploadposts/google-business/place-actions, PATCH /api/uploadposts/google-business/place-actions, POST /api/uploadposts/google-business/place-actions |
invalid_platforms | 400 | Missing username, or an invalid connect_theme, ui_labels, client_approval (true or false; checked while post approvals are on) or preserve_settings. | POST /api/uploadposts/users/generate-jwt |
invalid_post_id | 400 | Invalid request, or Google rejected it. | GET /api/uploadposts/google-business/posts/get |
invalid_post_url | 400 | Missing fields, no account connected, an active monitor already exists for this post, or the comments cannot be read (reconnect). | GET /api/uploadposts/comments, POST /api/uploadposts/autodms/start |
invalid_preserve_settings | 400 | Missing username, or an invalid connect_theme, ui_labels, client_approval (true or false; checked while post approvals are on) or preserve_settings. | POST /api/uploadposts/users/generate-jwt |
invalid_profile_username | 400 | Invalid filter. | GET /api/uploadposts/teams/audit, POST /api/uploadposts/webhooks/subscriptions |
invalid_query | 400 | Invalid request, or Google rejected it. | GET /api/uploadposts/google-business/categories |
invalid_read_mask | 400 | Invalid request, or Google rejected it. | GET /api/uploadposts/google-business/food-menus, GET /api/uploadposts/google-business/location-info, GET /api/uploadposts/google-business/location-info/google-updated and 3 more |
invalid_reason | 400 | Invalid request, or Google rejected it. | POST /api/uploadposts/google-business/google-locations/report |
invalid_region_code | 400 | Invalid request, or Google rejected it. | GET /api/uploadposts/google-business/attributes/available, GET /api/uploadposts/google-business/categories, GET /api/uploadposts/google-business/categories/batch and 1 more |
invalid_request_id | 400 | Invalid request, or Google rejected it. | POST /api/uploadposts/google-business/locations/create |
invalid_review_name | 400 | Invalid request, or Google rejected it. | DELETE /api/uploadposts/google-business/reviews/reply, GET /api/uploadposts/google-business/reviews/get, POST /api/uploadposts/google-business/reviews/reply and 1 more |
invalid_role | 400 | Invalid request, or Google rejected it. | PATCH /api/uploadposts/google-business/admins, POST /api/uploadposts/google-business/admins |
invalid_scheduled_date | 400 | Invalid body. | POST /api/uploadposts/approvals/{approval_id}/approve |
invalid_scope | 400 | Invalid request, or Google rejected it. | DELETE /api/uploadposts/google-business/admins, GET /api/uploadposts/google-business/admins, PATCH /api/uploadposts/google-business/admins and 1 more |
invalid_search | 400 | Invalid request, or Google rejected it. | POST /api/uploadposts/google-business/google-locations/search |
invalid_source | 400 | Invalid request. | POST /api/uploadposts/webhooks/subscriptions |
invalid_source_url | 400 | Invalid request, or Google rejected it. | POST /api/uploadposts/google-business/media |
invalid_status | 400 | Invalid status. | GET /api/uploadposts/approvals, GET /api/uploadposts/webhooks/subscriptions |
invalid_target_id | 400 | Invalid filter. | GET /api/uploadposts/teams/audit |
invalid_target_type | 400 | Invalid request, or Google rejected it. | GET /api/uploadposts/google-business/invitations |
invalid_update_mask | 400 | Invalid request, or Google rejected it. | PATCH /api/uploadposts/google-business/lodging |
invalid_uri | 400 | Invalid request, or Google rejected it. | PATCH /api/uploadposts/google-business/place-actions, POST /api/uploadposts/google-business/place-actions |
invalid_url | 400 | Invalid request. | POST /api/uploadposts/webhooks/subscriptions |
invalid_verification_method | 400 | Invalid request, or Google rejected it. | POST /api/uploadposts/google-business/verification/start |
invalid_verification_name | 400 | Invalid request, or Google rejected it. | POST /api/uploadposts/google-business/verification/complete |
invalid_view | 400 | Invalid request, or Google rejected it. | GET /api/uploadposts/google-business/categories, GET /api/uploadposts/google-business/categories/batch |
invitation_not_found | 404 | Not found. | POST /api/uploadposts/google-business/invitations/accept, POST /api/uploadposts/google-business/invitations/decline |
last_owner | 409 | Conflict. | DELETE /api/uploadposts/google-business/admins, PATCH /api/uploadposts/google-business/admins |
link_not_editable | 400 | Invalid request, or Google rejected it. | PATCH /api/uploadposts/google-business/place-actions |
linkedin_comment_not_found | 404 | (Instagram/Facebook do not know the comment_id) or linkedin_comment_not_found (a bare LinkedIn comment_id not among the post's first 250 comments; pass the comment_urn). Bluesky thread view: (Bluesky cannot find the post or reply). | GET /api/uploadposts/comments |
linkedin_page_access_denied | 403 | The connected account lacks the required scope (e.g. YouTube not connected with youtube.force-ssl). LinkedIn replies (comment_id): (personal-profile connection) or linkedin_page_access_denied (Page connection LinkedIn refused); the top-level LinkedIn listing passes LinkedIn's own 403 through. Bluesky thread view: (a block between the account and the post's author). | GET /api/uploadposts/comments |
linkedin_permission_missing | 403 | : the connection lacks the company Page permission (rw_organization_admin); reconnect LinkedIn approving it. | GET /api/uploadposts/linkedin/resolve-organization |
linkedin_person_not_resolvable | 400 | (missing user/url, not a LinkedIn Page) or linkedin_person_not_resolvable (a person's profile URL). Also profile_not_found (no profile with that user) and, without error_code, a profile with no LinkedIn connection. | GET /api/uploadposts/linkedin/resolve-organization |
linkedin_personal_not_supported | 403 | The connected account lacks the required scope (e.g. YouTube not connected with youtube.force-ssl). LinkedIn replies (comment_id): (personal-profile connection) or linkedin_page_access_denied (Page connection LinkedIn refused); the top-level LinkedIn listing passes LinkedIn's own 403 through. Bluesky thread view: (a block between the account and the post's author). | GET /api/uploadposts/comments |
linkedin_unavailable | 502 | : LinkedIn did not answer. | GET /api/uploadposts/linkedin/resolve-organization |
location_cannot_be_deleted | 409 | Conflict. | DELETE /api/uploadposts/google-business/locations/delete, POST /api/uploadposts/google-business/locations/delete |
location_check_unavailable | 503 | Temporarily unavailable; nothing was sent to Google. | DELETE /api/uploadposts/google-business/admins, GET /api/uploadposts/google-business/admins, GET /api/uploadposts/google-business/performance and 4 more |
location_edit_rate_limited | 429 | Rate or daily limit reached; retry after retry_after_seconds when present. | PATCH /api/uploadposts/google-business/attributes, PATCH /api/uploadposts/google-business/location-info, PATCH /api/uploadposts/google-business/lodging and 5 more |
location_not_found | 404 | Not found. | DELETE /api/uploadposts/google-business/admins, DELETE /api/uploadposts/google-business/locations/delete, DELETE /api/uploadposts/google-business/media and 45 more |
location_required | 400 | Invalid request, or Google rejected it. | DELETE /api/uploadposts/google-business/locations/delete, DELETE /api/uploadposts/google-business/media, DELETE /api/uploadposts/google-business/place-actions and 41 more |
lodging_not_supported | 400 | Invalid request, or Google rejected it. | GET /api/uploadposts/google-business/lodging, GET /api/uploadposts/google-business/lodging/google-updated, PATCH /api/uploadposts/google-business/lodging |
media_field_not_editable | 400 | Invalid request, or Google rejected it. | PATCH /api/uploadposts/google-business/media |
MEDIA_LIMIT_REACHED | 409 | Google refused the upload: the location already has the 100 items the API can add. | POST /api/uploadposts/google-business/media |
media_name_required | 400 | Invalid request, or Google rejected it. | DELETE /api/uploadposts/google-business/media, GET /api/uploadposts/google-business/media/customers/get, GET /api/uploadposts/google-business/media/get and 1 more |
media_not_found | 404 | Not found. | DELETE /api/uploadposts/google-business/media, GET /api/uploadposts/google-business/media/customers/get, GET /api/uploadposts/google-business/media/get and 1 more |
media_outcome_unknown | 504 | Google did not confirm the result. | POST /api/uploadposts/google-business/media |
media_source_required | 400 | Invalid request, or Google rejected it. | POST /api/uploadposts/google-business/media |
MEDIA_TOO_LARGE | 413 | Payload too large. | POST /api/uploadposts/google-business/media |
MEDIA_TOO_SMALL | 400 | Invalid request, or Google rejected it. | POST /api/uploadposts/google-business/media |
media_upload_busy | 429 | Rate or daily limit reached; retry after retry_after_seconds when present. | POST /api/uploadposts/google-business/media |
metric_retired | 400 | Invalid request, or Google rejected it. | GET /api/uploadposts/google-business/performance |
missing_comment | 400 | Invalid request, or Google rejected it. | POST /api/uploadposts/google-business/reviews/reply, PUT /api/uploadposts/google-business/reviews/reply |
missing_required_fields | 400 | Missing fields, unsupported platform or invalid Telegram parameter. | POST /api/uploadposts/posts/repost |
no_facebook_pages | 404 | Profile not found, or the account manages no Page. | GET /api/uploadposts/facebook/page-info, PATCH /api/uploadposts/facebook/page-info |
no_fields | 400 | Invalid request. | GET /api/uploadposts/facebook/page-info, PATCH /api/uploadposts/facebook/page-info, PATCH /api/uploadposts/google-business/attributes and 7 more |
no_google_update | 409 | Conflict. | POST /api/uploadposts/google-business/location-info/google-updates |
no_locations | 404 | Not found. | DELETE /api/uploadposts/google-business/locations/delete, DELETE /api/uploadposts/google-business/media, DELETE /api/uploadposts/google-business/place-actions and 38 more |
NO_QUEUE_SLOTS | 409 | Already closed; reviewed version is outdated (current_version and item included); an Editor's post whose date already passed (it becomes expired); a draft proposing a past date; changed meanwhile; or no free queue slot. | POST /api/uploadposts/approvals/client/{approval_id}/approve, POST /api/uploadposts/approvals/{approval_id}/approve |
not_found | 404 | Not found. | DELETE /api/uploadposts/webhooks/subscriptions/{subscription_id}, GET /api/uploadposts/webhooks/deliveries/{delivery_id}, GET /api/uploadposts/webhooks/subscriptions/{subscription_id} and 2 more |
not_redeliverable | 409 | Nowhere to send it, or it cannot be sent again (a removed webhook or subscription, a disabled subscription, a blocked URL or a real-time event that is not kept). | POST /api/uploadposts/webhooks/deliveries/{delivery_id}/redeliver |
NOTIFICATION_SETTING_IN_USE | 409 | Another tool receives this Google account's notifications; send "force": true to replace it. | PATCH /api/uploadposts/google-business/notifications, PUT /api/uploadposts/google-business/notifications |
organization_not_found | 404 | : no Page with that vanity or id (remembered for 7 days). Also User not found. | GET /api/uploadposts/linkedin/resolve-organization |
owner_not_found | 404 | Not found. | POST /api/uploadposts/approvals/{approval_id}/approve |
owner_only | 403 | Not allowed. | DELETE /api/uploadposts/google-business/admins, PATCH /api/uploadposts/google-business/accounts, PATCH /api/uploadposts/google-business/admins and 4 more |
ownership_changes_disabled | 403 | Not allowed. | DELETE /api/uploadposts/google-business/admins, PATCH /api/uploadposts/google-business/accounts, PATCH /api/uploadposts/google-business/admins and 4 more |
partner_only | 403 | Not allowed. | POST /api/uploadposts/google-business/verification/token |
platform_not_supported | 400 | (only tiktok acts on comments today), tiktok_reconnect_required (reconnect the account), or invalid_parameter (TikTok error 40002: a comment that was deleted, a post_id that is not one of the account's videos, pin on a reply; retrying fails the same way). | GET /api/uploadposts/comments, POST /api/uploadposts/comments/action |
post_approvals_disabled | 503 | Post approvals are switched off. | DELETE /api/uploadposts/approvals/{approval_id}, GET /api/uploadposts/approvals, GET /api/uploadposts/approvals/client and 6 more |
post_not_owned | 403 | X: the tweet is not from a connected account. | GET /api/uploadposts/post-analytics |
preserve_settings_conflict | 400 | Missing username, or an invalid connect_theme, ui_labels, client_approval (true or false; checked while post approvals are on) or preserve_settings. | POST /api/uploadposts/users/generate-jwt |
PROFILE_BLOCKED | 403 | Not allowed by the platform or the plan. | GET /api/uploadposts/users/validate-jwt, POST /api/uploadposts/posts/repost |
PROFILE_LIMIT_REACHED | 403 | The plan's profile limit is reached, with current_profiles and profile_limit (Business plans go over it with usage-based billing). | POST /api/uploadposts/users |
profile_not_found | 400, 404 | Not found. | DELETE /api/uploadposts/google-business/admins, DELETE /api/uploadposts/google-business/locations/delete, DELETE /api/uploadposts/google-business/media and 70 more |
PROFILE_NOT_FOUND | 404 | Unknown platform, or profile not found. | POST /api/uploadposts/oauth/{platform}/start |
QUEUE_BUSY | 409 | Already closed; reviewed version is outdated (current_version and item included); an Editor's post whose date already passed (it becomes expired); a draft proposing a past date; changed meanwhile; or no free queue slot. | POST /api/uploadposts/approvals/client/{approval_id}/approve, POST /api/uploadposts/approvals/{approval_id}/approve |
rate_limited | 429 | (60 live lookups per hour per account, retry_after seconds) or linkedin_rate_limited. | GET /api/uploadposts/linkedin/resolve-organization |
reddit_unavailable | 503 | Reddit connections temporarily unavailable. | POST /api/uploadposts/oauth/{platform}/start |
REPLY_TOO_LONG | 400 | Invalid request, or Google rejected it. | POST /api/uploadposts/google-business/reviews/reply, PUT /api/uploadposts/google-business/reviews/reply |
rule_limit_reached | 409 | error_code duplicate_rule (with rule_id), rule_limit_reached or rule_creation_in_progress. | POST /api/uploadposts/autodms/rules |
same_account | 400 | Invalid request, or Google rejected it. | POST /api/uploadposts/google-business/locations/transfer |
scheduled_date_in_past | 409 | Already closed; reviewed version is outdated (current_version and item included); an Editor's post whose date already passed (it becomes expired); a draft proposing a past date; changed meanwhile; or no free queue slot. | POST /api/uploadposts/approvals/client/{approval_id}/approve, POST /api/uploadposts/approvals/{approval_id}/approve |
services_not_supported | 400 | Invalid request, or Google rejected it. | GET /api/uploadposts/google-business/services, PUT /api/uploadposts/google-business/services |
STAGING_MONTHLY_BYTES_LIMIT | 429 | Too many uploads in progress (Retry-After), or monthly files/bytes limit. | POST /api/uploadposts/media-uploads |
STAGING_MONTHLY_FILES_LIMIT | 429 | Too many uploads in progress (Retry-After), or monthly files/bytes limit. | POST /api/uploadposts/media-uploads |
STAGING_UPLOADS_IN_PROGRESS | 429 | Too many uploads in progress (Retry-After), or monthly files/bytes limit. | POST /api/uploadposts/media-uploads |
subscription_disabled | 409 | The subscription is disabled, or its URL is not an allowed destination. | POST /api/uploadposts/webhooks/deliveries/{delivery_id}/redeliver, POST /api/uploadposts/webhooks/subscriptions/{subscription_id}/test |
subscription_limit_reached | 409 | Too many active subscriptions (limit in limit). | POST /api/uploadposts/webhooks/subscriptions |
subscription_removed | 409 | Nowhere to send it, or it cannot be sent again (a removed webhook or subscription, a disabled subscription, a blocked URL or a real-time event that is not kept). | POST /api/uploadposts/webhooks/deliveries/{delivery_id}/redeliver |
subscriptions_disabled | 503 | Redelivery temporarily disabled, or webhook subscriptions switched off for a delivery of a subscription. | POST /api/uploadposts/webhooks/deliveries/{delivery_id}/redeliver |
team_member_forbidden | 403 | Team members cannot change where the owner's notifications go. | POST /api/uploadposts/webhooks/subscriptions |
team_page_forbidden | 403 | Not allowed for this member. | PATCH /api/uploadposts/approvals/{approval_id} |
team_profile_forbidden | 403 | Not allowed for this member. | GET /api/uploadposts/approvals, GET /api/uploadposts/approvals/{approval_id}, GET /api/uploadposts/teams/audit and 1 more |
team_role_forbidden | 403 | Not allowed for this member. | GET /api/uploadposts/approvals, GET /api/uploadposts/approvals/{approval_id}, GET /api/uploadposts/teams/audit and 3 more |
telegram_api_error | 502 | The platform failed. | POST /api/uploadposts/posts/edit |
telegram_forbidden | 403 | The connected account cannot edit this post. | POST /api/uploadposts/posts/edit |
telegram_invalid_parameter | 400 | Missing fields, unsupported platform or invalid Telegram parameter. | POST /api/uploadposts/posts/edit, POST /api/uploadposts/posts/repost |
telegram_message_not_allowed | 403 | Not allowed by the platform or the plan. | POST /api/uploadposts/posts/repost |
telegram_message_not_found | 404 | Post not found. | POST /api/uploadposts/posts/edit |
telegram_not_enough_rights | 403 | telegram_not_enough_rights. | GET /api/uploadposts/telegram/share-theme-backdrops, GET /api/uploadposts/telegram/users/{user_id}/personal-chat-messages, GET /api/uploadposts/telegram/users/{user_id}/profile-audios and 1 more |
telegram_outcome_unknown | 504 | Telegram did not answer in time; do not retry blindly (retryable: false). | POST /api/uploadposts/posts/repost, POST /api/uploadposts/telegram/stars/refund |
telegram_rate_limited | 429 | telegram_rate_limited (with retry_after). | GET /api/uploadposts/telegram/share-theme-backdrops, GET /api/uploadposts/telegram/users/{user_id}/personal-chat-messages, GET /api/uploadposts/telegram/users/{user_id}/profile-audios and 2 more |
telegram_reconnect_required | 502 | The platform failed. | POST /api/uploadposts/posts/edit |
telegram_stars_spend_disabled | 503 | Not generally available yet. | POST /api/uploadposts/telegram/gifts, POST /api/uploadposts/telegram/gifts/premium, POST /api/uploadposts/telegram/invoices |
telegram_target_chat_unreachable | 403 | Not allowed by the platform or the plan. | POST /api/uploadposts/posts/repost |
threads_read_replies_required | 400 | Missing fields, no account connected, an active monitor already exists for this post, or the comments cannot be read (reconnect). | POST /api/uploadposts/autodms/start |
tiktok_reconnect_required | 400 | Missing fields, no account connected, an active monitor already exists for this post, or the comments cannot be read (reconnect). | GET /api/uploadposts/comments, POST /api/uploadposts/autodms/start, POST /api/uploadposts/comments/action and 1 more |
too_many_menu_photos | 400 | Invalid request, or Google rejected it. | PUT /api/uploadposts/google-business/food-menus |
trusted_partner_token_required | 400 | Invalid request, or Google rejected it. | POST /api/uploadposts/google-business/verification/start |
unauthorized | 401 | Missing or invalid profile JWT. | GET /api/uploadposts/approvals/client, POST /api/uploadposts/approvals/client/{approval_id}/approve, POST /api/uploadposts/approvals/client/{approval_id}/reject |
user_not_found | 404 | Not found. | DELETE /api/uploadposts/google-business/admins, DELETE /api/uploadposts/google-business/locations/delete, DELETE /api/uploadposts/google-business/media and 64 more |
user_required | 400 | Invalid request. | DELETE /api/uploadposts/google-business/admins, DELETE /api/uploadposts/google-business/locations/delete, DELETE /api/uploadposts/google-business/media and 68 more |
verification_required | 400 | Invalid request, or Google rejected it. | POST /api/uploadposts/google-business/verification/complete |
version_required | 400 | Invalid body. | POST /api/uploadposts/approvals/client/{approval_id}/approve, POST /api/uploadposts/approvals/{approval_id}/approve |
webhook_removed | 409 | Nowhere to send it, or it cannot be sent again (a removed webhook or subscription, a disabled subscription, a blocked URL or a real-time event that is not kept). | POST /api/uploadposts/webhooks/deliveries/{delivery_id}/redeliver |
webhook_subscriptions_disabled | 503 | Webhook subscriptions are switched off. | DELETE /api/uploadposts/webhooks/subscriptions/{subscription_id}, GET /api/uploadposts/webhooks/subscriptions, GET /api/uploadposts/webhooks/subscriptions/{subscription_id} and 2 more |
x_daily_write_limit | 429 | Daily limit. | POST /api/uploadposts/comments/create, POST /api/uploadposts/posts/edit, POST /api/uploadposts/posts/repost |
x_links_not_allowed | 400 | Missing fields, nothing to update, unsupported platform or invalid value. | POST /api/uploadposts/comments/create, POST /api/uploadposts/posts/edit |
youtube_channel_busy | 409 | — | PATCH /api/uploadposts/youtube/channel |
youtube_daily_budget_exhausted | 429 | Daily write limit or YouTube budget reached (retry_after). | POST /api/uploadposts/posts/edit |
youtube_default_language_required | 400 | Missing fields, nothing to update, unsupported platform or invalid value. | POST /api/uploadposts/posts/edit |
youtube_feature_disabled | 503 | Not generally available yet. | DELETE /api/uploadposts/youtube/captions/{caption_id}, DELETE /api/uploadposts/youtube/channel/sections/{section_id}, DELETE /api/uploadposts/youtube/channel/watermark and 50 more |
youtube_invalid_publish_at | 400 | Missing fields, nothing to update, unsupported platform or invalid value. | POST /api/uploadposts/posts/edit |
youtube_localization_ambiguous | 400 | — | PATCH /api/uploadposts/youtube/playlists/{playlist_id} |
youtube_localization_not_found | 404 | — | PATCH /api/uploadposts/youtube/playlists/{playlist_id} |
youtube_quota_exhausted | 429 | Daily write limit or YouTube budget reached (retry_after). | POST /api/uploadposts/posts/edit |
youtube_reporting_job_in_use | 409 | — | DELETE /api/uploadposts/youtube/reporting/jobs/{job_id} |
youtube_shared_budget_exhausted | 429 | Daily write limit or YouTube budget reached (retry_after). | POST /api/uploadposts/posts/edit |