Skip to main content

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_codeWhat happenedWhat to do
account_blockedA scheduled post was not sent because the account is blocked.Contact support.
account_checkpoint_requiredThe platform put the account behind a security checkpoint.Log in on the platform and clear the checkpoint, then retry.
account_pending_deletionA scheduled post was not sent because the account is waiting to be deleted.Restore the account to publish again.
account_permission_deniedThe connection lacks a permission the post needs.Reconnect granting every requested permission.
account_reauth_requiredThe platform no longer accepts the connection (token expired or revoked).Reconnect the account; retrying without reconnecting fails again.
account_restrictedThe platform restricted the account (spam or policy).Resolve it on the platform; Upload-Post stops posting to it meanwhile.
config_target_missingThe connection works but the target (Page, board, location, chat...) is missing or wrong.Select or fix the target, then retry.
content_duplicateThe platform rejected the post as a duplicate.Change the content.
content_rejectedThe platform rejected the content.Change the content.
cost_cap_reachedA per-account spending cap for this platform was reached.Retry later.
daily_cap_reachedThe profile used its posts for the last 24 hours on that platform.Retry later or schedule the post.
instagram_publishing_limit_reachedInstagram'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_failedUpload-Post could not download the media URL.Check the URL is public and retry.
media_invalid_formatThe media does not meet the platform's requirements.Fix the file (see the media requirements pages).
monthly_limit_reachedThe account's monthly upload allowance is used up.Upgrade the plan or wait for the next period.
platform_integration_pausedUpload-Post paused publishing to this platform for a while.Retry later.
platform_rate_limitedThe platform asked us to slow down.Retry later.
platform_unavailableThe platform failed or timed out.Retry later.
profile_blocked_by_planA 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_foundA 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_capTikTok's daily active-user quota for the app is used up (TikTok's own code).Retry tomorrow.
telegram_paid_broadcast_not_allowedTelegram 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_rejectedTikTok accepted the job and then rejected the media (format, duration, frame rate...).Fix the video and post again.
tiktok_privacy_unavailableThe TikTok account cannot publish with the requested privacy level.Use one of the levels GET /uploadposts/tiktok/settings returns.
tiktok_publish_failedTikTok accepted the job and then failed to publish it.Retry.
unknown_errorNot classified.Read the error message; contact support if it repeats.
upload_interruptedThe 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_outcomeThe 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_exceededThe YouTube API quota for today is used up.Retry after midnight Pacific Time.
youtube_channel_daily_limitYouTube 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_codeHTTPMeaningReturned by
account_name_required400Invalid request, or Google rejected it.PATCH /api/uploadposts/google-business/accounts, POST /api/uploadposts/google-business/accounts
account_not_found404Not found.DELETE /api/uploadposts/google-business/admins, GET /api/uploadposts/google-business/accounts/get, GET /api/uploadposts/google-business/admins and 4 more
account_required400Invalid 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_unavailable403The 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_found404Not found.DELETE /api/uploadposts/google-business/admins, PATCH /api/uploadposts/google-business/admins
admin_required400Invalid request, or Google rejected it.POST /api/uploadposts/google-business/admins
already_reposted409Threads: already reposted.POST /api/uploadposts/posts/repost
approval_closed409Already 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_expired409Already 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_failed500The job could not be created.POST /api/uploadposts/approvals/client/{approval_id}/approve, POST /api/uploadposts/approvals/{approval_id}/approve
approval_not_found404Not found.DELETE /api/uploadposts/approvals/{approval_id}, GET /api/uploadposts/approvals/{approval_id}, PATCH /api/uploadposts/approvals/{approval_id} and 4 more
approval_state_changed409Already 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_changed409Already 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_unavailable503Temporarily 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_url409The 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_blocked403The 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_limit429Daily limit.POST /api/uploadposts/posts/repost
bluesky_feature_disabled503Bluesky reposts not available yet.POST /api/uploadposts/posts/action, POST /api/uploadposts/posts/repost
bluesky_invalid_parameter400Missing 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_found404(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_unconfirmed504—POST /api/uploadposts/dms/send
category_required400Invalid request, or Google rejected it.PATCH /api/uploadposts/google-business/media
client_approval_not_allowed403The 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_found404(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_required400Missing or invalid comment.POST /api/uploadposts/approvals/client/{approval_id}/reject, POST /api/uploadposts/approvals/{approval_id}/reject
commercial_disclosure_invalid_value400Missing fields, nothing to update, unsupported platform or invalid value.POST /api/uploadposts/posts/edit
confirmation_required400Invalid 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_inputs400Invalid request, or Google rejected it.POST /api/uploadposts/google-business/verification/start
connected_identity409Conflict.DELETE /api/uploadposts/google-business/admins, PATCH /api/uploadposts/google-business/admins
daily_limit429X daily limit (limit, retry_after).GET /api/uploadposts/post-analytics
daily_limit_reached429Rate 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_disabled503Redelivery temporarily disabled, or webhook subscriptions switched off for a delivery of a subscription.POST /api/uploadposts/webhooks/deliveries/{delivery_id}/redeliver
elaboration_required400Invalid request, or Google rejected it.POST /api/uploadposts/google-business/google-locations/report
event_unsubscribed409Nowhere 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_error502Error on Facebook's side.GET /api/uploadposts/facebook/page-info, PATCH /api/uploadposts/facebook/page-info
facebook_not_connected400Invalid request.GET /api/uploadposts/facebook/page-info, PATCH /api/uploadposts/facebook/page-info
facebook_page_not_accessible400Invalid request.GET /api/uploadposts/facebook/page-info, PATCH /api/uploadposts/facebook/page-info
facebook_page_required400Invalid request.GET /api/uploadposts/facebook/page-info, PATCH /api/uploadposts/facebook/page-info
facebook_permission_denied403The account lacks a permission to list its Pages.GET /api/uploadposts/users/facebook-page
facebook_permission_missing403Meta requires pages_manage_metadata (pending App Review).PATCH /api/uploadposts/facebook/page-info
facebook_reauth_required401Facebook session expired or revoked (reauth_required: true).GET /api/uploadposts/users/facebook-page
facebook_reconnect_required401Facebook token no longer valid.GET /api/uploadposts/facebook/page-info, PATCH /api/uploadposts/facebook/page-info
facebook_validation_error400Invalid request.GET /api/uploadposts/facebook/page-info, PATCH /api/uploadposts/facebook/page-info
FIELD_NOT_EDITABLE400—PATCH /api/uploadposts/users/{username}
food_menus_not_supported400Invalid request, or Google rejected it.GET /api/uploadposts/google-business/food-menus, PUT /api/uploadposts/google-business/food-menus
gbp_feature_disabled503Temporarily 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_unavailable503Temporarily 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_unavailable503Temporarily 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_error502Google 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_connected400Invalid 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_exhausted429Rate 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_limited429Rate 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_unknown502Google 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_unreachable502Google 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_unavailable503Temporarily unavailable; nothing was sent to Google.DELETE /api/uploadposts/google-business/admins, PATCH /api/uploadposts/google-business/admins
invalid_account400Invalid 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_type400Invalid request, or Google rejected it.GET /api/uploadposts/google-business/accounts, POST /api/uploadposts/google-business/accounts
invalid_action400Invalid filter.GET /api/uploadposts/teams/audit
invalid_actor400Invalid filter.GET /api/uploadposts/teams/audit
invalid_admin400Invalid request, or Google rejected it.POST /api/uploadposts/google-business/admins
invalid_admin_name400Invalid request, or Google rejected it.DELETE /api/uploadposts/google-business/admins, PATCH /api/uploadposts/google-business/admins
invalid_api400Invalid request, or Google rejected it.GET /api/uploadposts/google-business/services, PUT /api/uploadposts/google-business/services
invalid_before400Invalid filter.GET /api/uploadposts/approvals
invalid_body400Invalid body.PATCH /api/uploadposts/approvals/{approval_id}, POST /api/uploadposts/approvals/{approval_id}/approve, POST /api/uploadposts/webhooks/subscriptions
invalid_breakdown400Invalid request, or Google rejected it.GET /api/uploadposts/google-business/performance
invalid_category400Invalid request, or Google rejected it.GET /api/uploadposts/google-business/attributes/available
invalid_chain400Invalid request, or Google rejected it.GET /api/uploadposts/google-business/chains/get
invalid_chain_name400Invalid request, or Google rejected it.GET /api/uploadposts/google-business/chains
invalid_client_approval400Missing 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_comment400Invalid 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_id400Missing 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_context400Invalid request, or Google rejected it.POST /api/uploadposts/google-business/verification/options, POST /api/uploadposts/google-business/verification/start
invalid_cursor400Invalid filter.GET /api/uploadposts/comments, GET /api/uploadposts/teams/audit
invalid_date400Invalid filter.GET /api/uploadposts/teams/audit
invalid_date_range400Invalid request, or Google rejected it.GET /api/uploadposts/google-business/performance
invalid_decision400Invalid request, or Google rejected it.POST /api/uploadposts/google-business/location-info/google-updates
invalid_description400Invalid request, or Google rejected it.POST /api/uploadposts/google-business/media
invalid_destination_account400Invalid request, or Google rejected it.POST /api/uploadposts/google-business/locations/transfer
invalid_edit_mode400Invalid request, or Google rejected it.PATCH /api/uploadposts/google-business/location-info, POST /api/uploadposts/google-business/location-info
invalid_elaboration400Invalid request, or Google rejected it.POST /api/uploadposts/google-business/google-locations/report
invalid_email_address400Invalid request, or Google rejected it.POST /api/uploadposts/google-business/verification/start
invalid_event400event is not one of the subscription's events (allowed_events).POST /api/uploadposts/webhooks/subscriptions/{subscription_id}/test
invalid_events400Invalid request.POST /api/uploadposts/webhooks/subscriptions
invalid_field400Invalid request.GET /api/uploadposts/facebook/page-info, PATCH /api/uploadposts/facebook/page-info, PATCH /api/uploadposts/google-business/attributes and 8 more
invalid_fields400Invalid request, or Google rejected it.POST /api/uploadposts/google-business/location-info/google-updates
invalid_filter400Invalid request, or Google rejected it.GET /api/uploadposts/google-business/locations/list
invalid_google_location400Invalid request, or Google rejected it.POST /api/uploadposts/google-business/google-locations/report
invalid_invitation400Invalid request, or Google rejected it.POST /api/uploadposts/google-business/invitations/accept, POST /api/uploadposts/google-business/invitations/decline
invalid_json400Invalid 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_code400Invalid 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_limit400Invalid filter.GET /api/uploadposts/approvals, GET /api/uploadposts/teams/audit
invalid_link400Invalid 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_id400Invalid 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_lodging400Invalid request, or Google rejected it.PATCH /api/uploadposts/google-business/lodging
invalid_mailer_contact400Invalid request, or Google rejected it.POST /api/uploadposts/google-business/verification/start
invalid_media_category400Invalid request, or Google rejected it.PATCH /api/uploadposts/google-business/media, POST /api/uploadposts/google-business/media
invalid_media_file400Invalid request, or Google rejected it.POST /api/uploadposts/google-business/media
invalid_media_format400Invalid request, or Google rejected it.POST /api/uploadposts/google-business/media
invalid_media_name400Invalid 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_source400Invalid request, or Google rejected it.POST /api/uploadposts/google-business/media
invalid_menus400Invalid request, or Google rejected it.PUT /api/uploadposts/google-business/food-menus
invalid_metric400Invalid request, or Google rejected it.GET /api/uploadposts/google-business/performance
invalid_month_range400Invalid request, or Google rejected it.GET /api/uploadposts/google-business/performance/keywords
invalid_name400Invalid request.POST /api/uploadposts/webhooks/subscriptions
invalid_names400Invalid request, or Google rejected it.GET /api/uploadposts/google-business/categories/batch
invalid_notification_type400Invalid request, or Google rejected it.PATCH /api/uploadposts/google-business/notifications, PUT /api/uploadposts/google-business/notifications
invalid_order_by400Invalid request, or Google rejected it.GET /api/uploadposts/google-business/locations/list
invalid_page_size400Invalid 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_token400Invalid 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_parameter400The 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_number400Invalid request, or Google rejected it.POST /api/uploadposts/google-business/verification/start
invalid_pin400Invalid request, or Google rejected it.POST /api/uploadposts/google-business/verification/complete
invalid_place_action_type400Invalid 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_platforms400Missing 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_id400Invalid request, or Google rejected it.GET /api/uploadposts/google-business/posts/get
invalid_post_url400Missing 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_settings400Missing 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_username400Invalid filter.GET /api/uploadposts/teams/audit, POST /api/uploadposts/webhooks/subscriptions
invalid_query400Invalid request, or Google rejected it.GET /api/uploadposts/google-business/categories
invalid_read_mask400Invalid 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_reason400Invalid request, or Google rejected it.POST /api/uploadposts/google-business/google-locations/report
invalid_region_code400Invalid 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_id400Invalid request, or Google rejected it.POST /api/uploadposts/google-business/locations/create
invalid_review_name400Invalid 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_role400Invalid request, or Google rejected it.PATCH /api/uploadposts/google-business/admins, POST /api/uploadposts/google-business/admins
invalid_scheduled_date400Invalid body.POST /api/uploadposts/approvals/{approval_id}/approve
invalid_scope400Invalid 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_search400Invalid request, or Google rejected it.POST /api/uploadposts/google-business/google-locations/search
invalid_source400Invalid request.POST /api/uploadposts/webhooks/subscriptions
invalid_source_url400Invalid request, or Google rejected it.POST /api/uploadposts/google-business/media
invalid_status400Invalid status.GET /api/uploadposts/approvals, GET /api/uploadposts/webhooks/subscriptions
invalid_target_id400Invalid filter.GET /api/uploadposts/teams/audit
invalid_target_type400Invalid request, or Google rejected it.GET /api/uploadposts/google-business/invitations
invalid_update_mask400Invalid request, or Google rejected it.PATCH /api/uploadposts/google-business/lodging
invalid_uri400Invalid request, or Google rejected it.PATCH /api/uploadposts/google-business/place-actions, POST /api/uploadposts/google-business/place-actions
invalid_url400Invalid request.POST /api/uploadposts/webhooks/subscriptions
invalid_verification_method400Invalid request, or Google rejected it.POST /api/uploadposts/google-business/verification/start
invalid_verification_name400Invalid request, or Google rejected it.POST /api/uploadposts/google-business/verification/complete
invalid_view400Invalid request, or Google rejected it.GET /api/uploadposts/google-business/categories, GET /api/uploadposts/google-business/categories/batch
invitation_not_found404Not found.POST /api/uploadposts/google-business/invitations/accept, POST /api/uploadposts/google-business/invitations/decline
last_owner409Conflict.DELETE /api/uploadposts/google-business/admins, PATCH /api/uploadposts/google-business/admins
link_not_editable400Invalid request, or Google rejected it.PATCH /api/uploadposts/google-business/place-actions
linkedin_comment_not_found404(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_denied403The 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_missing403: the connection lacks the company Page permission (rw_organization_admin); reconnect LinkedIn approving it.GET /api/uploadposts/linkedin/resolve-organization
linkedin_person_not_resolvable400(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_supported403The 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_unavailable502: LinkedIn did not answer.GET /api/uploadposts/linkedin/resolve-organization
location_cannot_be_deleted409Conflict.DELETE /api/uploadposts/google-business/locations/delete, POST /api/uploadposts/google-business/locations/delete
location_check_unavailable503Temporarily 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_limited429Rate 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_found404Not found.DELETE /api/uploadposts/google-business/admins, DELETE /api/uploadposts/google-business/locations/delete, DELETE /api/uploadposts/google-business/media and 45 more
location_required400Invalid 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_supported400Invalid 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_editable400Invalid request, or Google rejected it.PATCH /api/uploadposts/google-business/media
MEDIA_LIMIT_REACHED409Google refused the upload: the location already has the 100 items the API can add.POST /api/uploadposts/google-business/media
media_name_required400Invalid 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_found404Not 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_unknown504Google did not confirm the result.POST /api/uploadposts/google-business/media
media_source_required400Invalid request, or Google rejected it.POST /api/uploadposts/google-business/media
MEDIA_TOO_LARGE413Payload too large.POST /api/uploadposts/google-business/media
MEDIA_TOO_SMALL400Invalid request, or Google rejected it.POST /api/uploadposts/google-business/media
media_upload_busy429Rate or daily limit reached; retry after retry_after_seconds when present.POST /api/uploadposts/google-business/media
metric_retired400Invalid request, or Google rejected it.GET /api/uploadposts/google-business/performance
missing_comment400Invalid request, or Google rejected it.POST /api/uploadposts/google-business/reviews/reply, PUT /api/uploadposts/google-business/reviews/reply
missing_required_fields400Missing fields, unsupported platform or invalid Telegram parameter.POST /api/uploadposts/posts/repost
no_facebook_pages404Profile not found, or the account manages no Page.GET /api/uploadposts/facebook/page-info, PATCH /api/uploadposts/facebook/page-info
no_fields400Invalid request.GET /api/uploadposts/facebook/page-info, PATCH /api/uploadposts/facebook/page-info, PATCH /api/uploadposts/google-business/attributes and 7 more
no_google_update409Conflict.POST /api/uploadposts/google-business/location-info/google-updates
no_locations404Not 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_SLOTS409Already 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_found404Not 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_redeliverable409Nowhere 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_USE409Another 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_found404: no Page with that vanity or id (remembered for 7 days). Also User not found.GET /api/uploadposts/linkedin/resolve-organization
owner_not_found404Not found.POST /api/uploadposts/approvals/{approval_id}/approve
owner_only403Not allowed.DELETE /api/uploadposts/google-business/admins, PATCH /api/uploadposts/google-business/accounts, PATCH /api/uploadposts/google-business/admins and 4 more
ownership_changes_disabled403Not allowed.DELETE /api/uploadposts/google-business/admins, PATCH /api/uploadposts/google-business/accounts, PATCH /api/uploadposts/google-business/admins and 4 more
partner_only403Not allowed.POST /api/uploadposts/google-business/verification/token
platform_not_supported400(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_disabled503Post approvals are switched off.DELETE /api/uploadposts/approvals/{approval_id}, GET /api/uploadposts/approvals, GET /api/uploadposts/approvals/client and 6 more
post_not_owned403X: the tweet is not from a connected account.GET /api/uploadposts/post-analytics
preserve_settings_conflict400Missing 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_BLOCKED403Not allowed by the platform or the plan.GET /api/uploadposts/users/validate-jwt, POST /api/uploadposts/posts/repost
PROFILE_LIMIT_REACHED403The 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_found400, 404Not 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_FOUND404Unknown platform, or profile not found.POST /api/uploadposts/oauth/{platform}/start
QUEUE_BUSY409Already 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_limited429(60 live lookups per hour per account, retry_after seconds) or linkedin_rate_limited.GET /api/uploadposts/linkedin/resolve-organization
reddit_unavailable503Reddit connections temporarily unavailable.POST /api/uploadposts/oauth/{platform}/start
REPLY_TOO_LONG400Invalid request, or Google rejected it.POST /api/uploadposts/google-business/reviews/reply, PUT /api/uploadposts/google-business/reviews/reply
rule_limit_reached409error_code duplicate_rule (with rule_id), rule_limit_reached or rule_creation_in_progress.POST /api/uploadposts/autodms/rules
same_account400Invalid request, or Google rejected it.POST /api/uploadposts/google-business/locations/transfer
scheduled_date_in_past409Already 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_supported400Invalid request, or Google rejected it.GET /api/uploadposts/google-business/services, PUT /api/uploadposts/google-business/services
STAGING_MONTHLY_BYTES_LIMIT429Too many uploads in progress (Retry-After), or monthly files/bytes limit.POST /api/uploadposts/media-uploads
STAGING_MONTHLY_FILES_LIMIT429Too many uploads in progress (Retry-After), or monthly files/bytes limit.POST /api/uploadposts/media-uploads
STAGING_UPLOADS_IN_PROGRESS429Too many uploads in progress (Retry-After), or monthly files/bytes limit.POST /api/uploadposts/media-uploads
subscription_disabled409The 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_reached409Too many active subscriptions (limit in limit).POST /api/uploadposts/webhooks/subscriptions
subscription_removed409Nowhere 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_disabled503Redelivery temporarily disabled, or webhook subscriptions switched off for a delivery of a subscription.POST /api/uploadposts/webhooks/deliveries/{delivery_id}/redeliver
team_member_forbidden403Team members cannot change where the owner's notifications go.POST /api/uploadposts/webhooks/subscriptions
team_page_forbidden403Not allowed for this member.PATCH /api/uploadposts/approvals/{approval_id}
team_profile_forbidden403Not allowed for this member.GET /api/uploadposts/approvals, GET /api/uploadposts/approvals/{approval_id}, GET /api/uploadposts/teams/audit and 1 more
team_role_forbidden403Not allowed for this member.GET /api/uploadposts/approvals, GET /api/uploadposts/approvals/{approval_id}, GET /api/uploadposts/teams/audit and 3 more
telegram_api_error502The platform failed.POST /api/uploadposts/posts/edit
telegram_forbidden403The connected account cannot edit this post.POST /api/uploadposts/posts/edit
telegram_invalid_parameter400Missing fields, unsupported platform or invalid Telegram parameter.POST /api/uploadposts/posts/edit, POST /api/uploadposts/posts/repost
telegram_message_not_allowed403Not allowed by the platform or the plan.POST /api/uploadposts/posts/repost
telegram_message_not_found404Post not found.POST /api/uploadposts/posts/edit
telegram_not_enough_rights403telegram_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_unknown504Telegram did not answer in time; do not retry blindly (retryable: false).POST /api/uploadposts/posts/repost, POST /api/uploadposts/telegram/stars/refund
telegram_rate_limited429telegram_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_required502The platform failed.POST /api/uploadposts/posts/edit
telegram_stars_spend_disabled503Not generally available yet.POST /api/uploadposts/telegram/gifts, POST /api/uploadposts/telegram/gifts/premium, POST /api/uploadposts/telegram/invoices
telegram_target_chat_unreachable403Not allowed by the platform or the plan.POST /api/uploadposts/posts/repost
threads_read_replies_required400Missing 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_required400Missing 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_photos400Invalid request, or Google rejected it.PUT /api/uploadposts/google-business/food-menus
trusted_partner_token_required400Invalid request, or Google rejected it.POST /api/uploadposts/google-business/verification/start
unauthorized401Missing 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_found404Not found.DELETE /api/uploadposts/google-business/admins, DELETE /api/uploadposts/google-business/locations/delete, DELETE /api/uploadposts/google-business/media and 64 more
user_required400Invalid request.DELETE /api/uploadposts/google-business/admins, DELETE /api/uploadposts/google-business/locations/delete, DELETE /api/uploadposts/google-business/media and 68 more
verification_required400Invalid request, or Google rejected it.POST /api/uploadposts/google-business/verification/complete
version_required400Invalid body.POST /api/uploadposts/approvals/client/{approval_id}/approve, POST /api/uploadposts/approvals/{approval_id}/approve
webhook_removed409Nowhere 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_disabled503Webhook 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_limit429Daily limit.POST /api/uploadposts/comments/create, POST /api/uploadposts/posts/edit, POST /api/uploadposts/posts/repost
x_links_not_allowed400Missing fields, nothing to update, unsupported platform or invalid value.POST /api/uploadposts/comments/create, POST /api/uploadposts/posts/edit
youtube_channel_busy409—PATCH /api/uploadposts/youtube/channel
youtube_daily_budget_exhausted429Daily write limit or YouTube budget reached (retry_after).POST /api/uploadposts/posts/edit
youtube_default_language_required400Missing fields, nothing to update, unsupported platform or invalid value.POST /api/uploadposts/posts/edit
youtube_feature_disabled503Not 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_at400Missing fields, nothing to update, unsupported platform or invalid value.POST /api/uploadposts/posts/edit
youtube_localization_ambiguous400—PATCH /api/uploadposts/youtube/playlists/{playlist_id}
youtube_localization_not_found404—PATCH /api/uploadposts/youtube/playlists/{playlist_id}
youtube_quota_exhausted429Daily write limit or YouTube budget reached (retry_after).POST /api/uploadposts/posts/edit
youtube_reporting_job_in_use409—DELETE /api/uploadposts/youtube/reporting/jobs/{job_id}
youtube_shared_budget_exhausted429Daily write limit or YouTube budget reached (retry_after).POST /api/uploadposts/posts/edit