Skip to main content
Most publishing failures come down to one of three things: an expired token, a content rule a platform enforces, or a permissions gap. Here’s how to spot and fix each.

​
A post failed to publish

When a scheduled post fails, it stays in your queue with a red status and an error message. Open the post to see which platform failed and why — other platforms in the same post will still have gone out.
1

Open the failed post

Select it in the calendar or posts list. You’ll see a status per network.
2

Read the error

Hover the failed network to see the platform’s exact message.
3

Fix and retry

Either reconnect the account, edit the content, or remove the failing platform — then select Retry publish.

​
Common errors

The platform invalidated your access. Go to Settings → Social Accounts and select Reconnect next to the affected network. Then retry the post.Rheos auto-refreshes tokens where the platform allows it, but some (TikTok, X) need a manual reconnect every few months.
Your Instagram account needs to be Business or Creator (not personal) to publish via the API. Switch it in the Instagram app under Settings → Account type, then reconnect in Rheos.
If Rheos has recently added new features (e.g. company mentions), you may need to reconnect to grant the extra scopes. Disconnect and reconnect from Settings → Social Accounts.
Some networks have no text-only post type, so Rheos blocks scheduling or publishing to them until the post has media attached. This applies to Instagram, Pinterest, TikTok and YouTube Shorts. Add an image, carousel or video in the Attachments panel — or untick that platform for the post — and you’ll be able to publish.
Each network has its own rules. TikTok and Instagram Reels need vertical (9:16) video. X caps video at 2 minutes 20 seconds. Instagram caps carousels at 10 slides. Swap or re-encode the media and retry.
You’ve hit a platform’s posting cap (most enforce per-hour or per-day limits). Wait an hour and retry, or reschedule for later.
X and LinkedIn block exact-duplicate posts within a short window. Tweak the copy slightly and retry.

​
Still stuck?

Email support@rheos.app with the post title, the platform that failed, and the error message. We can usually diagnose within a few hours.
Last modified on June 22, 2026