Troubleshooting•4 min read•Updated August 2026
Publish Logs & Diagnostics
Resolve common publishing errors: token expirations, media dimension mismatches, and platform rate limits.
DiagnosticsError Codes
Location in App:app.hyperfast.in > Monitor > Publish Logs
Overview
When a social broadcast fails, HyperFast logs the exact error code returned by the remote platform's API and sends an immediate alert to your workspace administrator.
Step-by-Step Instructions
1
Locate Failed Post in Publish Logs
Go to Monitor > Publish Logs and filter by 'Failed'.
2
Click 'View Error Details'
Open the log inspector drawer to read the raw API error response and diagnosis recommendation.
3
Apply Fix & Retry
Make necessary caption/media adjustments, then click 'Retry Publish' to immediately re-dispatch.
Common Social Network API Errors & Fixes
| Platform | Error Message / Code | Root Cause | Actionable Fix |
|---|---|---|---|
| Meta (Instagram) | Error 100: Invalid aspect ratio | Image is not 1:1, 4:5, or 1.91:1 | Crop media in Create Post before scheduling |
| Meta (Facebook) | Session has expired (Error 190) | OAuth token revoked or expired | Go to Workspace > Integrations and click 'Reconnect' |
| X (Twitter) | Status is a duplicate (403) | Identical tweet text sent within 24h | Tweak caption wording or add unique hashtag |
| Throttle limit reached (429) | Exceeded 100 posts/day API limit | Pause queue for 2 hours and let backoff clear | |
| WordPress | 401 Unauthorized / Forbidden | Application Password deleted or CORS blocked | Regenerate Application Password in WP Admin Users Profile |
Was this guide helpful in configuring your workspace?