A social post failed

When a social post fails, the first place to look is Dashboard → Approvals → History. Every failed post is logged there with the error message from the platform.

Common failure reasons

1. Platform access token expired

Error you’ll see: “Authentication failed” / “Invalid credentials” / “Token expired”

Fix: Reconnect the account. Settings → Integrations → Social Media → [account] → Reconnect. You’ll go through the OAuth flow again, which issues a fresh token.

X/Twitter expires tokens more aggressively than other platforms — you may find yourself reconnecting that one monthly.

2. Rate-limited by the platform

Error: “Too many posts in a short window” / “Rate limit exceeded”

Each platform has its own limits:

• X personal accounts — 50 posts/24h (lower than you’d expect)
• X business accounts — higher
• LinkedIn personal — 20 posts/day
• LinkedIn company pages — 100/day
• Instagram — 25/24h for business accounts
• Facebook Pages — 25/24h
• Pinterest — 10/hour
• TikTok — 3/day for new accounts, more for established

Fix: Wait for the rate limit window to reset (usually 1-24 hours depending on the platform), then try again.

3. Content policy violation

Error: “Post violates community guidelines”

Platforms sometimes reject posts for automated content moderation reasons:

• Banned words or political content the platform classifies as risky
• Links to flagged domains (especially Facebook and Instagram — even harmless links get hit sometimes)
• Images flagged as NSFW even if they aren’t
• Too many hashtags (Instagram caps at 30)

Fix: Edit the content and resubmit. If you believe the flag is wrong, you can also try posting the same content directly from the platform’s own app to see if that works — if it does, it’s our intermediary being overly cautious and you can contact support.

4. Media upload failed

Error: “Image not accepted” / “Video format not supported”

Each platform has media requirements:

• Image formats: PNG, JPG, GIF (WebP supported on some platforms)
• Image dimensions: vary by platform — too small or too large triggers failures
• Video format: H.264 MP4 is safe everywhere
• Video length: X <2:20, LinkedIn <10min, Instagram <60sec (Reels) / <15min (main feed), TikTok <3min

Fix: Ask your agent to re-encode or resize the media, or use a different file.

5. Account suspended or restricted

Error: “Account not permitted to post”

Your own account may be under restriction on the platform (e.g., X sometimes temporarily restricts accounts for ToS violations). We can’t post on your behalf while that’s active.

Fix: Go to the platform directly and resolve whatever the platform is asking you to resolve. Once you can post manually, your agent will be able to post again.

6. Post for Me is down

Error: “Upstream service unavailable”

Post for Me is our social publishing proxy. If they’re having issues, we can’t publish on any platform. Rare but possible.

Fix: Check the status page for any incident. Wait 10-15 minutes and try again. If it’s an extended outage, Post for Me usually resolves within a few hours.

7. Our side has an internal error

Error: “Internal error” / “Unknown”

Something broke on our end. Your agent logs the details and we see it on our side.

Fix: Retry once. If it fails again, wait 10 minutes and retry. If still failing, email support with the approval ID from the History tab.

Dry-run before publishing

If you’re about to post something important (product launch, announcement, etc.) and you want to minimize the chance of failure, ask your agent to do a dry run:

“Do a dry run of this LinkedIn post — validate the content against LinkedIn’s rules, check my connection status, check rate limits, but don’t actually publish. Tell me if there are any red flags.”

Your agent will check everything and tell you whether it’s safe to actually send. Then you can approve the real post with confidence.

Scheduled posts that failed

If a scheduled social post failed, check Scheduler → [task] → History. The run entry shows the error. You can:

• Retry now — manually trigger the next run immediately
• Edit and retry — fix the content and run again
• Reschedule — change the schedule and let it run normally

Failed scheduled posts are not automatically retried on the next interval — we don’t want your agent to spam the platform with a broken post.

Getting the actual error

Sometimes the UI shows “Post failed” without the full reason. To get the full error:

1. Approvals → History
2. Click into the failed item
3. Raw response tab — shows exactly what the platform told us

Include that error when you email support — it’s the fastest path to a fix.