Error reference

Social media API errors and troubleshooting

A practical reference for failed social media publishing jobs. Find the platform that failed, identify the error type, and decide whether the next step is reconnecting the account, fixing the payload, replacing media, or retrying later.

Last updated: July 2026

Platform-specific error references for publishing, scheduling, media, permissions, and rate limits

Troubleshooting paths for reconnect, fix input, retry later, and platform issue cases

Written for support teams, developers, and customer-facing publishing workflows

Start with the platform that failed

A failed Instagram post, TikTok video, Slack message, and Reddit submission can all look like a generic publishing error in a product UI, but the cause is usually platform-specific. Instagram failures often happen around media containers, TikTok can block privacy or spam-risk combinations, Slack can return ok false in the response body, and Reddit can reject posts because of community rules.

Map the error to the right action

Most failed posts fall into one of four actions: reconnect the account, fix the input, retry later, or wait for the platform. Token, scope, revoked-access, and permission failures belong in the reconnect path. Caption limits, unsupported media, missing fields, duplicate content, and invalid URLs need a payload or content change. Rate limits, processing delays, timeouts, and 5xx responses need a delayed retry.

Keep reconnects rare and specific

A reconnect is useful when the platform no longer trusts the token, the user changed permissions, a required scope is missing, or the account can no longer access the target page, channel, profile, or location. It will not fix an expired media URL, a rejected video format, a policy block, a duplicate post, a community rule, or a temporary platform outage.

Retry only when the same request can succeed later

Retry temporary platform failures, processing delays, timeouts, 5xx responses, and rate-limit errors after the platform allows it. Do not immediately retry validation, permissions, unsupported media, account restriction, or policy failures. The same payload usually needs to change before it can publish successfully.

Use the platform pages for exact checks

Choose a platform below to search native error messages, normalized Bundle error keys, likely causes, and recommended retry behavior. Each page ties the failure to the account, publish stage, media requirement, permission state, and next user-facing action.

Complete reference

Search the API error catalog

Looking for a specific Bundle error key or native platform code? Search the complete API error reference.

Search complete error reference

FAQ

Should every failed post ask the user to reconnect?

No. Reconnect only for token, scope, account access, or permission failures. Most publishing failures need a media, content, payload, platform setting, or retry timing fix.

Why are errors split by platform?

Each social network has different auth rules, media constraints, rate limits, policy checks, and response shapes. Platform-specific pages keep troubleshooting close to the native API behavior.

Can platform error messages change?

Yes. Treat exact platform wording as a signal, then confirm the failed stage, affected account, payload, media file, and platform state before choosing the next action.

When is a retry safe?

Retry when the platform response is temporary, such as a timeout, processing delay, 429, or 5xx response. Do not retry unchanged payloads after validation, permission, account restriction, unsupported media, duplicate content, or policy failures.

Platform error pages

Browse API errors by platform

TikTok API errors

Privacy settings, spam risk, creator eligibility, media pulls, and posting volume limits.

Instagram API errors

Media containers, Graph API sessions, publishing limits, product tags, and account quality.

Facebook API errors

Page roles, Meta sessions, Business Manager rules, malformed links, and policy blocks.

YouTube API errors

Quota, channel permissions, upload processing, thumbnails, copyright checks, and Content ID.

X API errors

Duplicate posts, usage caps, blocked URLs, API tier limits, credentials, and media duration.

LinkedIn API errors

Member tokens, organization roles, missing scopes, duplicate content, and media processing.

Google Business Profile API errors

Location eligibility, field masks, read-only attributes, verification state, quota, and concurrency.

Threads API errors

Meta tokens, linked Instagram state, app review, media fetch, video format, and processing.

Reddit API errors

Subreddit rules, flair requirements, account age, karma, spam filters, removals, and rate limits.

Pinterest API errors

Board validation, media fetch, unsupported files, video cover images, processing, and rate limits.

Bluesky API errors

PDS routing, sessions, record validation, blob uploads, moderation, and app-view propagation.

Discord API errors

Webhook tokens, channel permissions, slowmode, missing guilds, attachments, and payload validation.

Mastodon API errors

Instance availability, OAuth, account restrictions, validation, federation, media, and scheduled posts.

Slack API errors

ok false responses, missing scopes, channel membership, archived channels, Retry-After, and payload limits.

Build with less platform drag

Use one API for social publishing workflows

Create account