How to use this page#
Find the message you see, word for word, in the tables below, or paste it into the docs search: it jumps straight here. Messages are grouped by where they appear.
Text in {braces} changes each time: a network, an account name, a number or a date. Messages that come from a social network itself are passed through word for word; they're marked "the network's own message".
If your message isn't here, or the fix doesn't work, contact support with the exact text and a screenshot.
Any page#
| Message | What it means | What to do |
|---|---|---|
| "An unexpected error occurred while processing your request." | Heropost couldn't finish what you asked, and the detailed reason isn't shown. | Reload the page and try again. Check the common causes below. If it keeps happening, contact support with what you were doing, the time and a screenshot. |
| "Something went wrong on our end. Please try again — if it keeps happening, contact support." | A technical problem on Heropost's side. | Try again in a moment. If it repeats, contact support. |
| "We're having trouble reaching Heropost right now. Check your connection and try again." | Your browser couldn't reach Heropost. | Check your internet connection, VPN or firewall, then reload. |
| "Looks like you've reached the limit of your plan. Please upgrade your account to access for features." | You tried to go past a plan limit: social accounts, workspaces, team members or the analytics history your plan covers. | See Billing → Usage. Remove something you don't use, or upgrade. → Upgrade or change your plan |
| "Your account doesn't have an active plan. Please upgrade to use this feature." | The account, or the owner of the workspace you're in, has no active plan. | Pick a plan in Billing. In someone else's workspace, ask the owner. → Plans compared |
| Time to Level up! — "Upgrade to get unlimited access and unlock more features." | Your plan doesn't include this. Usually an older lifetime deal: some don't include X, TikTok, Google Business Profile, Threads or Bluesky, or have fewer AI captions or a shorter analytics history. | Press Upgrade to see your options. → Lifetime plans explained |
| Your Plan Has Expired — "Your Heropost subscription is no longer active. Renew your plan or switch to a lifetime deal to get your features back." | Your subscription ended, or a renewal payment failed. | Press View Plans. If a payment failed, see If a payment fails. |
Common causes of "An unexpected error occurred…"#
- Adding a Telegram channel or group: the bot token is wrong, the bot isn't an administrator of the channel or group, or the chat isn't a channel, group or supergroup. Check all three, then add it again. → Connect Telegram
- Adding a Bluesky account: check the username and password. If you use two-factor authentication, use an App Password from your Bluesky settings. → Connect Bluesky
- Replying to an Instagram direct message: the Facebook Page linked to that Instagram account must be connected in the same workspace. → The Social Inbox
- Changing a post while it publishes or after it has published. Refresh the page; to post it again, use Duplicate. → Edit, reschedule or delete a post
- Sending Ideas and Bugs reports: the same report twice within a day, or more than 10 reports in an hour.
- In a connected AI tool: the month's AI actions are used up. See Connected AI tools.
Connecting accounts#
| Message | What it means | What to do |
|---|---|---|
| "Authentication cancelled" | The network's sign-in window was closed or blocked before you finished, or you declined. | Allow pop-ups for app.heropost.io, try again and finish the steps in the network's window. → The account list is empty |
| "Facebook's sign-in could not open because Facebook's script did not load in this browser. If you use an ad blocker or tracking protection, switch it off for Heropost, then reload the page and try again." | An ad blocker, privacy extension or strict tracking protection stopped Facebook's sign-in (Facebook and Instagram). | Switch it off for app.heropost.io, reload and try again. A private window without extensions is a quick test. |
| "Selected account not found" | While reconnecting, the network didn't return that account for the profile you signed in with. | Sign in with a profile that manages the account (on Facebook: full control of the Page), and tick that Page or account when the network asks. → Reconnect an account |
| "This account needs updated permissions. Please disconnect it and reconnect through Heropost, making sure to approve all requested permissions in the Facebook dialog." | Facebook didn't grant a permission Heropost needs. | Reconnect, and leave every permission switched on in Facebook's window. |
| "Failed to reconnect account. Please try again." | Reconnecting didn't finish. | Try again. If it repeats, contact support. |
| "Failed to connect X account. Please try again." | Connecting X didn't finish. | Try again. |
| "Invalid token format." | X's sign-in came back incomplete. | Connect X again. |
| "Connecting an X account requires X posting credits. Purchase an X credit pack first." | A new X connection needs X credits. Reconnecting doesn't. | Buy a pack in Billing → Add-ons, then connect X again. → X credits |
| "This account cannot be added to the workspace, as it already exists." | The account is already in this workspace. | Nothing to do. To refresh its connection, use ⋮ → Reconnect. |
| "Login error: There is an error in logging you into this application. Please try again later." or "Error logging in. An error occurred when logging you into this app." | The network's own message: Facebook refused the sign-in on its own page. | On Facebook, open Settings & privacy → Settings → Business integrations, remove HeroPost, then connect again in Heropost with every permission on. Check facebook.com/accountquality and use your main Facebook profile. → Connect Facebook |
| "Could not connect LinkedIn inbox" | Connecting the LinkedIn inbox didn't finish. | Try again from Accounts → ⋮ → Connect inbox. → Connect the LinkedIn inbox |
Plan messages ("Looks like you've reached the limit of your plan…", Time to Level up!) can also appear when you connect an account: see Any page.
Post editor: text and settings#
These appear in the editor while you write, or when you hover a grayed-out Publish All or Schedule All button.
| Message | What it means | What to do |
|---|---|---|
| "Please select accounts for {network}" | A network is switched on for this post, but no account is ticked. | Tick an account on that network's tab, or switch the network off with the gear → Posting Settings. → The post editor |
| "Post incomplete. {reason}" or "{network} post incomplete. {reason}" | Something that network needs is missing. The reason says what. | Fix it on that network's tab. |
| "{field} is required", for example "Media is required", "Caption is required", "Link is required", "URL is required", "Title is required" | A required field is empty. Instagram, Pinterest, YouTube and TikTok need media; YouTube needs a title; link posts need a link. | Fill in the field on that network's tab. → Character limits and media specs |
| "You can have up to {N} characters in {field}" | The text is longer than the network allows. | Shorten it on that network's tab. → Character limits and media specs |
| "You can have up to 30 hashtags in {field}" | More than 30 hashtags. | Remove some. |
| "Tweet is not valid. You can have up to 280 characters." | The X text is over 280 characters, counted the way X counts them: links and emoji have their own weights. | Shorten the X version. → Connect X |
| "Invalid URL" | The link isn't a full web address. | Use the whole address, starting with https://. |
| "Angled brackets aren't allowed" | YouTube titles and descriptions can't contain the characters < or >. | Remove them. → Connect YouTube |
| "Please specify Privacy Level" | TikTok needs Who can watch this video. | Choose an option on the TikTok tab. → Connect TikTok |
| "You need to indicate if your content promotes yourself, a third party, or both." | Disclose post content is on, but no option is chosen. | Choose Your brand, Branded content, or both. |
| "Branded Content can only be configured with visibility as public/friends" | Branded content can't be private on TikTok. | Change Who can watch this video, or switch off branded content. |
| "Invalid link for the button" | The Google Business Profile button needs a valid link. | Enter a full link, or choose Call now. → Connect Google Business Profile |
| "Scheduled date cannot be before {date}." | The date and time are in the past. | Choose a future date and time. → Schedule, publish now, or save a draft |
| "Post already published. Repost settings can only be configured on Draft or Scheduled Posts" | Repeats can only be set on drafts and scheduled posts. | Duplicate the post and set Repost Settings on the copy. → Repeat a post |
Post editor: photos and videos#
| Message | What it means | What to do |
|---|---|---|
| "Too many files. Max: {n}" | You added more files than the post can take. | Remove some. → Add photos and videos |
| "You can upload up to {n} files" or "You can upload only 1 file" | Too many files for this network. Stories take exactly one. | Remove some. |
| "You can upload up to 4 images or 1 video or 1 gif" | X takes up to 4 images, or 1 video, or 1 GIF. | Change the media on the X tab. |
| "You can upload up to 9 images or 1 video" | LinkedIn's limit. | Change the media on the LinkedIn tab. |
| "You can upload up to 5 images or 1 video" | Pinterest's limit. | Change the media on the Pinterest tab. |
| "Images must have the same width/height ratios" | Pinterest Pins with several images need images of the same shape. | Crop them to the same ratio. |
| "You can upload up to 20 images or 1 video" | Reddit's limit. | Change the media on the Reddit tab. |
| "You can upload up to 4 images or 1 video" | Bluesky's limit. | Change the media on the Bluesky tab. |
| "Sorry, you can't add both photos and a video at the same time" | A Facebook post takes photos or one video, not both. | Keep the photos or the video. |
| "Please select only one video file at a time" | This network takes one video per post. | Keep one video. |
| "Gifs in media groups are not supported" | On Telegram, a GIF can't be part of an album. | Post the GIF on its own. |
| "Wrong file format. Please upload {formats}" | This network doesn't accept that file type. | Convert the file to one of the formats listed. → Character limits and media specs |
| "Image size limit: {N}MB maximum" or "Video size limit: {N}MB maximum" | The file is bigger than this network allows, for example images over 1 MB on Bluesky, 5 MB on X or 8 MB on Instagram. | Compress or resize the file. |
| "Duration of the video must be between 3 seconds and 15 minutes", and other ranges | The video is too short or too long. Facebook 3 s to 20 min; Stories 3 to 60 s; Instagram, LinkedIn and Reddit 3 s to 15 min; X 0.5 to 140 s; Pinterest 4 s to 15 min; YouTube up to 15 min; TikTok 3 s up to your account's maximum; Bluesky up to 60 s. | Trim the video. |
| "Codec is not supported. For more information please check requirements" | Your browser can't read the video. | Export it again as an MP4 (H.264) and upload that. |
| Incorrect Image — "Oops, your image does not correspond to {network} requirements: {details}" | The image's shape or size doesn't fit Instagram, Pinterest or Google Business Profile. | Press Go to Editor to crop or resize it. |
| "Aspect ratio must be within a 9:16.15 to 1.91:1 range." | The image is too tall or too wide for an Instagram post. | Crop it. |
| "This image is too small. Make sure your images are at least {width} x {height} pixels. Current image is {width} x {height}" | Pinterest needs at least 200 x 300 pixels; Google Business Profile 400 x 300. | Use a larger image. |
| "This image is too big. Make sure your images are at most 10000 x 10000 pixels. Current image is {width} x {height}" | Too large for Google Business Profile. | Resize it. |
| "Wrong file format. Please upload PNG or JPG" or "Size limit: {N}MB maximum" | A thumbnail or watermark that isn't JPG or PNG, or too big: thumbnails up to 10 MB on Facebook, 8 MB on Instagram, 2 MB on YouTube; watermarks up to 10 MB. | Use a JPG or PNG within the size. |
Scheduling and publishing#
These appear as a message at the bottom of the screen when you press Schedule All, Publish All or Publish now. Nothing is sent until you fix them.
| Message | What it means | What to do |
|---|---|---|
| "Unable to post because Instagram requires media." | Instagram posts need at least one photo or video. | Add media on the Instagram tab. |
| "Unable to post because Instagram Story requires 1 media." or "Unable to post because Facebook Story requires 1 media." | A Story takes exactly one photo or video. | Keep one file, or change Post Type. |
| "Unable to post because {network} requires link." (Facebook, LinkedIn, Threads, Telegram, Bluesky) | The post type is Link, but there's no link. | Add the link, or change Post Type. |
| "Unable to post because {network} requires caption or at least 1 media." (Facebook, Threads, Telegram) or "… requires caption or media." (LinkedIn, Bluesky, X, Google My Business) | There's nothing to post on that network. | Add text or media on its tab. |
| "Unable to post because {network} requires caption for link post." (Threads, Telegram) | A link post needs text too. | Add a caption. |
| "Unable to post because {network} does not support a combination of different media types." (Facebook, Bluesky) | Photos and a video in the same post. | Keep photos only, or one video. |
| "Unable to post because {network} does not support posting multiple videos." (Facebook, Bluesky) | More than one video. | Keep one video. |
| "Unable to post because Telegram doesn't allow more than 1024 characters in the caption if the post contains media." | With photos or a video, Telegram captions stop at 1,024 characters. | Shorten the caption, or send the text without media. |
| "It is impossible to set this time: {date}, because it does not meet the requirement: the time must be more than the current one (UTC + 0) by 10 seconds and the number of seconds must be 0." | The time has passed, or is only a few seconds away. | Pick a later time. |
| "Post {id} is pending approval. It must be approved or rejected in Team > Approvals before it can be scheduled or published." | The post is waiting for approval. | Approve it in Team → My Approvals, or ask someone who can. → Approvals |
| "Post {id} cannot be published because it has no active selected social networks to publish." | Every network is switched off for this post. | Switch one on in Posting Settings and tick an account. |
| "Post {id} cannot be published because one or more of the selected social networks do not have active accounts." | A switched-on network has no account ticked. | Tick an account, or switch that network off. |
| "Post {id} cannot be published because it is in the process of publishing or has already been published." | The post is already going out, or has gone out. | Refresh the page. To post it again, use Duplicate. |
Failed posts: every network#
These are reasons on Content → Posting Errors, and on the account when you hover it in the editor. After fixing the cause, open the post and use Duplicate Failed to send it again: Heropost doesn't retry failed posts.
| Message | What it means | What to do |
|---|---|---|
| "This account is paused after repeated failed posts. Reconnect it to resume posting." In the editor: "{account} is paused, so this post was not published to it. Reconnect or contact support to resume posting." | Heropost paused the account after five failed posts in a row for reasons it can't recover from on its own: X accounts that are suspended, locked, not permitted to post or whose connection expired. | Fix the cause on the network, then Reconnect the account. → When a network limits an account |
| "You don't have a subscription" | The workspace owner had no active plan when the post was due. | Pick a plan in Billing, then send the post again. |
| "Your subscription does not include TikTok" (also Google My Business, Threads, Bluesky) | The owner's plan, an older lifetime deal, doesn't include that network. | Upgrade, or untick that network. → Lifetime plans explained |
| "Response status code does not indicate success: {code} ({reason})." | The network refused without saying why. 401 (Unauthorized) usually means the connection, or a media link, needs a sign-in. 400 (Bad Request) means something in the post was refused. | Reconnect the account, make sure media links open without signing in, then send it again. If it repeats, contact support. |
| "The file is too large" | A photo or video taken from a link (a CSV, an automation or an AI tool) is over 20 MB for a photo or 5 GB for a video. | Use a smaller file. |
| "Sequence contains no elements" | TikTok or YouTube was switched on for the post without a video. | Add a video on that tab, or switch the network off, then send it again. Check the other networks of that post too. |
| "Failed to create {network} post" or "Failed to create a comment to {network} post" | The heading of each entry on Posting Errors: the post, or only its first comment, failed. | Read the reason underneath it. |
Any other reason is the network's own message, passed through word for word (YouTube and Telegram, for example, always give their own). Read it for the cause; reconnecting fixes most messages about tokens, sessions or permissions.
Failed posts: Facebook#
| Message | What it means | What to do |
|---|---|---|
| "Facebook is temporarily limiting how often this account can post. Heropost paused publishing to it until {date and time} UTC to protect the account. This post was not published to it — schedule it again later." | Facebook is limiting this Page, so Heropost paused publishing to it until the time shown. Other accounts keep posting. | Wait until then, send the post again, and space posts out. Reconnecting doesn't help. → When a network limits an account |
| "Facebook has been limiting this page recently, and pages that keep posting after that are often blocked or locked by Facebook. To protect it, Heropost held this post back after {N} posts today. Reschedule it for tomorrow, or space posts out to lower the risk." | A daily hold for a Page that Facebook limited recently. | Reschedule for tomorrow and spread posts through the day. |
| "(#200) Permissions error" | The network's own message: a permission is missing, or the profile doesn't have full control of the Page. | Reconnect, tick the Page and leave every permission on. → Reconnect an account |
| "Error validating access token: The session has been invalidated because the user changed their password or Facebook has changed the session for security reasons" | The network's own message: the connection ended after a password change or a security reset. | Reconnect each Page, then each Instagram account linked to them. |
| "Error validating access token: Sessions for the user are not allowed because the user is not a confirmed user." | The network's own message: Facebook considers the profile that connected the Pages unconfirmed. | Confirm your email or phone on facebook.com, then reconnect the Pages and Instagram accounts. |
| "You cannot access the app till you log in to www.facebook.com and follow the instructions given." | The network's own message: Facebook put a security check on that profile. Instagram accounts connected through it stop too. | Log in at facebook.com and complete every step. If posts still fail, reconnect each Page, then each Instagram account. |
| "We limit how often you can post, comment or do other things in a given amount of time in order to help protect the community from spam" | The network's own message: Facebook is limiting the account. | Wait, then space posts out. |
| "Video was not published due to error. Code {code}: {message}" | Facebook couldn't process the video. | Export the video again (MP4, H.264) and send it again. |
| "Facebook took too long to process video. Eventually, Facebook marked it as expired." | Processing the video took too long. | Try again, ideally with a smaller file. |
| "Story could not be published." | Facebook refused the Story. | Try again. |
Failed posts: Instagram#
| Message | What it means | What to do |
|---|---|---|
| "Instagram is temporarily limiting how often this account can post. Heropost paused publishing to it until {date and time} UTC to protect the account. This post was not published to it — schedule it again later." | Instagram is limiting this account, so Heropost paused publishing to it until the time shown. | Wait until then, send the post again, and space posts out. → When a network limits an account |
| "We restrict certain activity to protect our community" | The network's own message: too many posts reached the account at the same moment. | Space posts minutes apart. For automations, set Check for New Posts to Every Hour. |
| "The media was not published due to error. {status}." | Instagram couldn't make a post from the file, for example "Media upload has failed with error code 2207053". | Check the file against Media Requirements in the upload box, export it again and try again. |
| "The Instagram Professional account is inactive, checkpointed, or restricted. Please sign in to the Instagram app and complete any actions the app requires to re-enable the account." | Instagram restricted the account. | Open the Instagram app and complete what it asks, then send the post again. |
| "Your post couldn't be published because Instagram is taking too long to process it. Please try again later." | Processing took too long. | Send it again later. |
| "The media container-{id} was not published within 24 hours and has expired." | Instagram expired the upload. | Send the post again. |
Messages about tokens, sessions or checkpoints on the Facebook profile also stop Instagram: see Failed posts: Facebook.
Failed posts: Threads#
| Message | What it means | What to do |
|---|---|---|
| "Threads is temporarily limiting how often this account can post. Heropost paused publishing to it until {date and time} UTC to protect the account. This post was not published to it — schedule it again later." | Threads is limiting this account, so Heropost paused publishing to it until the time shown. | Wait, then send it again and space posts out. → When a network limits an account |
| "Media was not published due to error. {error}" | Threads couldn't process the media. | Export it again and try again. |
| "Threads took too long to process video. Eventually, Threads marked it as expired." | Processing took too long. | Try again, ideally with a smaller file. |
| "Param text must be at most 500 characters long" | The network's own message: over 500 characters. | Shorten the Threads version. |
Failed posts: X#
On Posting Errors you'll see X's own message; hovering the account in the editor shows the plainer explanation in brackets.
| Message | What it means | What to do |
|---|---|---|
| "You have no X posting credits left. Buy an X credit pack to continue posting to X." (editor: "You've used this month's X posting credits. Buy an X credit pack to keep posting to {account} — free monthly credits reset on the 1st.") | No X credits left. Other networks still published. | Buy a pack, then send the X part again. → X credits |
| "This X account reached its daily posting limit. The post can be published again tomorrow." (editor: "{account} reached the daily X posting limit. Posting will resume tomorrow.") | Each X account can publish 50 posts a day through Heropost (UTC day). | Reschedule for tomorrow. |
| "{account} has been suspended by X. Posting is not possible until X reinstates the account." (editor) | X suspended the account. | Resolve it with X. |
| "The X connection for {account} has expired. Reconnect the account to resume posting." (editor) | The X connection ended. | Reconnect the account. → Reconnect an account |
| "X did not allow this post for {account}. Please check the account's status and permissions on x.com." (editor) | X refused the post. | Check the account on x.com. |
| "{account} is locked by X. Unlock it on x.com, then publish again." (editor) | X locked the account. | Unlock it on x.com, then send the post again. |
| "X posting is temporarily unavailable. If the issue persists, please contact support." | A problem between Heropost and X. No credit is used. | If it lasts, contact support. |
| "X API rate limited (429). Bucket '{bucket}' blocked until {time} (UTC)." | X is limiting requests for now. | Send it again after the time shown. |
| "X error. {X's message}" | The network's own reason, for example a duplicate post. | Act on X's reason. For a duplicate, change the text. |
| "The mediaId {id} upload has failed." or "The uploaded media has unexpected status {status}." | X couldn't process the media. | Export the file again within X's limits and try again. |
Failed posts: LinkedIn#
| Message | What it means | What to do |
|---|---|---|
| "LinkedIn error. The token used in the request has expired" | The LinkedIn connection ended. | Reconnect the account, signing in as the page admin. → Reconnect an account |
| "LinkedIn error. {LinkedIn's message}" | The network's own reason. | Act on it. Messages about tokens or permissions: reconnect. |
| "PostId cannot be retrieved" or "ETag cannot be retrieved" | LinkedIn didn't confirm the post. | Check LinkedIn to see whether it went out. If not, send it again. |
Failed posts: Pinterest#
| Message | What it means | What to do |
|---|---|---|
| "Pinterest error. {Pinterest's message}", for example "… is too long (constraint: maxLength=800)" | The network's own reason. Here, the description is over 800 characters. | Act on it; shorten the description. |
| "The media {id} failed to publish." | Pinterest couldn't process the video. | Export it again and try again. |
Failed posts: Google Business Profile#
| Message | What it means | What to do |
|---|---|---|
| "GMB error. {error}. {description}." | Google refused the post. When the message ends with "Please reconnect this GMB account with Heropost.", the connection ended. | Reconnect when the message asks; otherwise act on Google's reason. → Connect Google Business Profile |
Failed posts: Reddit#
| Message | What it means | What to do |
|---|---|---|
| "The Reddit connection for this account has expired. Reconnect the account to resume posting." | Reddit didn't renew the connection. | Reconnect the account. Reddit accounts aren't marked as needing a reconnect, so watch Posting Errors. |
| "Subreddit {name} doesn't support images" or "Subreddit {name} doesn't support videos" | That subreddit doesn't allow this media. | Post text or a link, or pick another subreddit. |
| "Posting media failed", "Submitting media failed" or "Submitting gallery failed" | Reddit refused the media. | Try again, and check the subreddit's rules. |
Failed posts: TikTok#
| Message | What it means | What to do |
|---|---|---|
| "The TikTok connection for this account has expired. Reconnect the account to resume posting." | TikTok didn't renew the connection. | Reconnect the account. → Reconnect an account |
| "TikTok did not renew the connection for this account ({error}: {description})." or "TikTok did not renew the connection for this account." | TikTok refused to renew the connection this time. | Send the post again. If it fails again, reconnect. |
| "The video could not be published. {reason}" | TikTok rejected the video. | Act on TikTok's reason; export the video again if needed. |
Failed posts: Bluesky#
| Message | What it means | What to do |
|---|---|---|
| "Invalid app.bsky.feed.post record: grapheme too big (maximum 300, got {N})" | The network's own message: over 300 characters as Bluesky counts them. | Shorten the Bluesky version. |
| "Account has been taken down" | The network's own message: Bluesky took the account down. | Resolve it with Bluesky. Meanwhile, untick the account in new posts and automations. |
Bulk upload#
| Message | What it means | What to do |
|---|---|---|
| "Please select a valid CSV file" | The file isn't a CSV. | Save it as a CSV and choose it again. → Bulk upload posts from a CSV |
| "Failed to start bulk upload" | The upload couldn't start. | Try again. |
| "The first row of your CSV needs exactly these column names: Caption, Media, Title, Date, Link, Thumbnail, Type, Comment." (may add "Missing: …" and "Your file has: …") | The header row is wrong or incomplete. | Make the first row exactly Caption,Media,Title,Date,Link,Thumbnail,Type,Comment. The Sample CSV in the window is a working example. |
| "Your CSV separates its columns with semicolons; they have to be separated by commas. …" | Spreadsheets set to some regions save CSVs with semicolons. | Save it again as a comma-separated UTF-8 CSV. |
| "Row {N} of your CSV has fewer columns than the first row. Every row needs all eight columns: leave a cell empty rather than leaving it out." | A row is missing columns. | Leave empty cells in place instead of removing them. |
| "Row {N} of your CSV could not be read. Text that contains a comma, a quotation mark or a line break has to be wrapped in double quotes." | Text in that row breaks the CSV format. | Wrap that cell in double quotes. |
| "Your CSV could not be read at row {N}." | Heropost couldn't read the file from that row. | Check the row, or start from the Sample CSV. |
| "Row {N}: No network in the posting group ({networks}) can publish this row as a {type} post with {n} video(s) and {n} photo(s). Check the Type column, and that each media link is a direct link ending in the file name (e.g. .mp4 or .jpg)." | None of the networks in your posting group can take that row as written. | Fix the Type column (for example Video for YouTube or TikTok), use direct media links, or choose another posting group. |
| "Failed to check bulk upload status" or "Bulk upload polling timeout" | Heropost couldn't confirm the result. | Check Content → Drafts before uploading again; each upload creates new drafts. |
| "Bulk upload completed successfully!" | Done. Your posts are drafts. | Schedule them from Content → Drafts. |
Hero_Agent#
| Message | What it means | What to do |
|---|---|---|
| "You've reached your action limit ({used}/{limit})." | This month's AI actions are used up. Nothing was charged; the action wasn't carried out. | Press Upgrade, or wait for the 1st of next month. → AI plans and your monthly AI allowance |
| "{used} of {limit} AI actions used this month — limit reached." | The same, on Home's meter. | Same. |
| "That's all {N} Hero_Agent chat turns for this month — they reset on {date}. Your connected AI tools keep working, and everything you've created stays where it is. To carry on chatting here now, raise your Hero_Agent plan in Billing." | This month's chat messages are used up. | Upgrade, or use a connected AI tool until the reset. |
| "Hero_Agent chat isn't part of the plan on this workspace. Everything you've already created stays exactly as it is — open Billing to pick a plan and carry on here." | The workspace owner has no plan. | The owner picks a plan in Billing. |
| "You're sending messages very quickly — give me a moment, then try again." | Too many messages in a short time. | Wait a moment, then send again. |
| "That message is too long ({n} characters; the limit is 120,000). Split it, or attach the text as a file." | One message can hold up to 120,000 characters. | Split it, or attach the text as a file. |
| "I ran out of room working that out before I could answer. Try a smaller batch — fewer accounts, days or posts a day — or ask again more narrowly." | The request was too big for one answer. | Start a new conversation and ask for fewer posts at a time. → Hero_Agent |
| "That document is over 200 KB — trim it to the parts about your business and try again." | Documents can be up to 200 KB. | Send a shorter document. |
| "Up to 3 documents per message — send the others in a follow-up." | Three documents per message. | Send the rest in another message. |
| "Excel / Numbers files aren’t supported yet — save it as CSV, or copy the rows and paste them here." | Hero_Agent reads CSV and TSV files, or pasted rows. | Save the sheet as CSV, or paste the rows. |
Hero_Photo#
| Message | What it means | What to do |
|---|---|---|
| "This needs {N} photo credits — you have {M}." In the studio: Not enough credits, "This needs {N} — you have {M}". | Not enough photo credits for this. | Buy a 100-credit pack (with a Hero_Agent plan) or upgrade. Other members see "Ask the workspace owner for more photo credits." → Hero_Photo credits |
| "This would use {N} credits — more than the {M} shown. Nothing was charged; check the price and try again." | The price changed after it was shown. | Check the new price and generate again. |
| "Couldn't start the generation — nothing was charged. Try again in a moment." | Generation didn't start. | Try again in a moment. |
| "{x} of {n} started and will land in your library; the other {y} couldn't start and weren't charged." | Some images started; the rest didn't and cost nothing. | Generate the missing ones again. |
| "The description is too long — keep it under 2,000 characters." | Descriptions can be up to 2,000 characters. | Shorten it. |
| "Pick a photo — videos can't be used as an input here." | This mode needs a photo. | Choose a photo. |
| "Pick up to five sizes at a time." | Repurpose makes up to five sizes at once. | Choose five or fewer. |
| "Your media storage is full — upgrade your plan for more storage to keep creating." | There's no room for new images on your plan. | Delete media you don't need, or upgrade. |
AI captions#
| Message | What it means | What to do |
|---|---|---|
| "Something went wrong" | The caption writer couldn't produce text this time. | Try again. If it keeps happening, contact support. → AI captions, hashtags and rewriting |
| Time to Level up! | On some older lifetime deals, the AI captions included each month are used up. | Upgrade, or wait for next month. |
Connected AI tools#
Your AI tool (ChatGPT, Claude, Cursor and others) shows these when it talks to Heropost.
| Message | What it means | What to do |
|---|---|---|
| "An agent key is required (Authorization: Bearer hp_ag_...)." | The link or key is missing or cut short. | Paste the whole Heropost link again, or make a New link. → AI tool connection problems |
| "That is not a Heropost link. Check it in Heropost under Home → Connect your AI tools → Your tools, or connect the tool again." | The link was changed, cut short, or replaced by a new one. | Copy it again from Your tools → Setup, or press New link. |
| "This link expired because it had not been used for 180 days. Make a new one in Heropost: Home → Connect your AI tools → Your tools." | Links expire after 180 days without use. | Press New link and update the tool. |
| "This link was removed. Connect the tool again in Heropost: Home → Connect your AI tools." | The tool was removed from Heropost. | Connect it again. |
| "Too many failed authentication attempts. Wait a minute and try again with a valid agent key." | Too many wrong links from your connection in a minute. | Wait a minute, then fix the link. |
| "Rate limit reached for this agent connection ({N} calls per minute). Wait a moment and retry." | The tool made too many calls in a minute, often in a loop. | Wait, then ask again. For many posts, ask for one batch. → Limits, rate limits and error messages |
| "Too many requests in flight for this account. Retry in a moment." | Too many calls at the same moment. | Try again in a moment. |
| "An unexpected error occurred while processing your request." | Often, the month's AI actions are used up. | Check Actions this month under Home → Connect your AI tools → Your tools. Upgrade, or wait for the 1st. |
| "Heropost API is unreachable right now. Retry in a moment.", "Heropost API request timed out. Retry in a moment.", "Heropost API returned an unexpected response (HTTP {code}).", "Heropost API request failed (HTTP {code}).", "Heropost API returned no data." | A temporary problem reaching Heropost. | Try again in a moment. |
| "Validation failed: {details}" | Something in the request broke a rule, such as a text limit. | Ask the tool to fix what the details say. |
| "This agent key is draft-only — it can't publish or schedule posts. …" | Publish and schedule is off for this tool. | Switch it on in Your tools → Permissions, or publish the draft yourself. → Links, permissions and activity |
| "This agent key is draft-only — it can't modify a post that has already been scheduled, published, or submitted for approval. …" | Same permission, for posts that aren't drafts. | Same. |
| "One or more accounts are outside this agent key's account scope. …" | The tool may only use some accounts. | Change Which accounts in Your tools → Permissions. |
| "This agent key is scoped to another workspace." | The tool used an ID from another workspace. | Connect the tool in that workspace, or use this workspace's accounts. |
| "This workspace requires human approval before posts can be scheduled or published. …" | Approvals are on. | The tool submits the post for approval; approve it in Team → My Approvals. |
| "This agent key doesn't have inbox access. …" or "This agent key can't reply or react in the inbox. …" | The tool's inbox permission is off. | Switch on Read the inbox or Reply in the inbox in Your tools → Permissions. |
| "Agent inbox access requires an agent add-on plan (Agent Growth or higher). …" | Reading the inbox from AI tools needs Growth or higher. | Upgrade the AI plan. |
| "Agent inbox replies require the Agent Pro or Agent Agency add-on. …" or, in the app, "Replying in the inbox is part of Agent Pro and Agent Agency. Raise the Hero_Agent plan and this can be switched on." | Replies from AI tools need Pro or Agency. | Upgrade, then switch on Reply in the inbox. |
| "scheduledDate {date} is not in the future …" | The time has passed or is seconds away. | Ask for a later time, or save without a date. |
| "All {N} AI tool connections on your plan are in use — …" | Every connection slot is used, across all your workspaces. | Remove a tool under Your tools (the message names where they are), or upgrade. |
| "Every connection slot on this plan is in use. Remove one to connect another, or raise your plan." | The same, under Your tools. | Same. |
| "A connection with this name already exists in this workspace." | That tool is already connected here. | Use Setup or New link on the existing one. |
| "No workspace is open yet. Pick a workspace, then connect the tool." | No workspace is selected. | Choose a workspace, then connect. |
| "Couldn't create a link for {tool}" | Heropost couldn't make the link. | Follow the reason shown, or press Try again. |
| "Your browser blocked the copy. Select the text above and copy it by hand." | The browser blocked the copy button. | Select the link and copy it by hand. |
| "Waiting for {tool}'s first call — this turns green by itself." | The tool hasn't reached Heropost yet. | Paste the full link with no authentication, restart the tool if needed, then ask it "Show my Heropost accounts". |
| "does not implement OAuth" (in ChatGPT) | ChatGPT's own message: Authentication was left on OAuth. | Add Heropost again with Authentication set to No authentication. → Connect ChatGPT |
Billing and plans#
| Message | What it means | What to do |
|---|---|---|
| "You already have a subscription, that is past due. Please pay the existing invoice." | Your last renewal payment failed, so new purchases are refused. | Contact support for the link to pay the invoice. → If a payment fails |
| "You already have a subscription. If you have issues accessing the platform, please try to re-login or contact the support." | You already pay for a plan. | Upgrade from Billing instead. → Upgrade or change your plan |
| "Looks like you already have a subscription. Please visit your billing or contact support for more details." | The same, on the plans page. To move to lifetime, contact support first. | Upgrade from Billing, or contact support. |
| "The selected price is only available to lifetime deal customers." | Member prices are for Lifetime Starter, Growth and Agency holders. | Log in to the account that holds the lifetime plan. |
| "The upgrade could not be completed. Please try again or manage your plan in the Stripe portal." | The upgrade or its payment didn't go through. A message from your card issuer may show instead. | Check your card under Invoices & payment methods, then try again. |
| "A single active subscription is required for an in-app upgrade. Please manage your plan in the billing portal." | There's more than one subscription on this login. | Contact support. |
| "The selected plan is not an available upgrade for your subscription." | That plan isn't a step up from yours. | Choose a card Billing offers, or contact support. |
| "The subscription is already on the selected price." | You're already on that plan. | Refresh Billing. |
| "To change your plan, use the Stripe billing portal via the links below." | Billing couldn't load upgrade options. | Use Invoices & payment methods, or contact support. |
| "Photo credit packs come with a Hero Agent plan." | Packs are for Hero_Agent plan subscribers. | Get an AI plan first. → AI plans and your monthly AI allowance |
| "Your Hero Agent plan is set to end on {date}, and pack credits end with it, so packs can't be bought while it's ending." or, in Billing, "…and pack credits end with it — so packs are paused." | Your Hero_Agent plan is canceled and ends on that date. | Keep the plan to buy packs. |
| "The request could not be processed." | A billing action failed for a reason that isn't shown. | Try again. If it repeats, contact support. |
Team invitations#
| Message | What it means | What to do |
|---|---|---|
| "This invitation has expired." | Invitations last 7 days. | Ask for a new invitation. → Invite your team |
| "This invitation was sent to {email}. Please log in with that account to accept." | You're signed in with a different email. | Sign out, then sign in with the invited email. |
Profile settings#
| Message | What it means | What to do |
|---|---|---|
| "Please upload file less than 2 MB" | The profile picture is too big. | Use an image under 2 MB. → Profile settings |
| "File format should be one of the following: *.jpg, *.png. *.gif" | Wrong file type. | Use JPG, PNG or GIF. |
Sign-in and sign-up#
These appear on Heropost's sign-in pages. Fixes in detail: Sign-in and email problems.
| Message | What it means | What to do |
|---|---|---|
| "Invalid email or password." | Wrong email or password. After 5 wrong passwords the account is locked for 15 minutes, with the same message. | Check the email, or reset your password with Forgot your password?. |
| "Account has been deactivated. To activate your account, contact your administrator." | This account was switched off. | Contact support. |
| "Unknown user status." | The account is in an unexpected state. | Contact support. |
| "Your email address still not verified" | You tried to log in before confirming your email. A new code or link was sent. | Enter the code, or press the link in the email. |
| "That code isn't right. Check the latest email and try again." | Wrong code, or an older one. | Use the code in the newest email. |
| "Too many wrong tries for this code. Send a new code." | Five wrong tries on one code. | Press Resend for a new code. |
| "Too many wrong codes. Use the link in the email instead." | Too many wrong tries on this account. | Press the link in the email. |
| "Too many tries from this network. Wait a while, or use the link in the email." | Too many tries from your internet connection. | Wait, or use the link. |
| This link has expired — "Log in to get a new code, or sign up again." | The confirmation link is old or already used. | Log in; Heropost sends a new code. |
| This link has expired — "It may have been used already. Sign in again and we'll send you a new one." | A Google or Facebook confirmation link is old or used. | Sign in again for a new link. |
| "User's email has already been verified." | You're already confirmed. | Log in. |
| "User is not found." | No account with that email. | Check the email, or sign up. |
| "Your password can't contain blank spaces." | Spaces aren't allowed in passwords. | Remove the spaces. |
| "Password should be from 7 to 20 character length and contain at least: 1 letter, 1 number and 1 special character (e.g. !@#$%^&*)." | The password doesn't meet the rules. | Use 7 to 20 characters with a letter, a number and a symbol. |
| "The password and confirmation password do not match." | The two passwords differ. | Type the same password twice. |
| "Please agree to our Terms of Services." | The terms switch is off. | Switch on I agree to all Terms of Services. |
| "Error from external provider: {error}" or "Error loading external login information." | Google or Facebook sign-in didn't complete. | Try again, or sign in with email. |
| "This Google account is connected to a different Heropost account." (or Facebook) | That Google or Facebook login belongs to another Heropost account. | Sign in to the other account, or use your email and password. |
| "Your sign-in timed out. Please try again." | The sign-in took too long. | Start again. |
| "Enter a valid email address." or "Too many tries. Wait a minute and try again." | On One more step, the email isn't valid, or too many tries. | Check the email; wait a minute if needed. |
| "Email claim not received from: {provider}" | Google or Facebook didn't share your email. | Sign in with email instead, or contact support. |
| "Google sign-in doesn't work inside the Instagram or Facebook app. Copy the link and open it in Safari or Chrome, or continue with Facebook or your email." | Google blocks sign-in inside those apps. | Press Copy link and open it in Safari or Chrome. |
| We have a problem — "Sorry, an error occurred while executing your request." | The sign-in page hit an error, often an old reset link. | Wait for the page to return to Log In, then try again. |
| 404 - Page not found — "Oops, better check that URL." | The address doesn't exist. | Go to the Log In page. |
| "Sorry, something went wrong." | The sign-in step failed. | Open Heropost again and sign in. |
| "In order for this website to function correctly, please prevent cross-site tracking of your cookies. …" | Safari's tracking prevention can block sign-in. | Follow the steps shown, then press I understand. |
| You are already logged in — "Do you want to proceed as {name}?" | You're signed in already. | Press Proceed, or Log out to switch account. |
| "Oops... {message}" (in Heropost) | Heropost couldn't complete your sign-in. | Reload the page and sign in again. |
Support and feedback#
| Message | What it means | What to do |
|---|---|---|
| "Something went wrong sending that. Please try again, or email support@heropost.ai." | The support chat couldn't send your message. | Try again, or email support@heropost.ai. → Get help |
| "You're sending messages quickly — give it a minute and try again." | Too many chat messages in a short time. | Wait a minute. |
| "Attachments must be images (jpg, png, gif, webp) or videos (mp4, mov, webm)." | Ideas and Bugs takes those file types only. | Attach a supported file. |
| "Videos must be smaller than 100 MB." or "Images must be smaller than 10 MB." | The attachment is too big. | Use a smaller file. |
| "One attachment failed to upload. Remove it and try again." | An attachment didn't upload. | Remove it and add it again. |
| "Something went wrong sending your report. Please try again." | The report wasn't sent. | Try again. |
| "Couldn't load your referral code. Please refresh the page — if it keeps happening, reach out to support." | Refer & Earn couldn't load. | Refresh the page. → Refer & Earn |
Questions#
My message isn't on this page. What do I do?
Paste the exact text into the docs search; messages are matched word for word. If nothing comes up, contact support with the message, what you were doing, the time and a screenshot.
Why does the message read like the network wrote it?
Because it did. When a post fails, Heropost passes the network's own reason on word for word, so you see exactly what Facebook, X or the other network said. The tables above explain the common ones.
Does Heropost try a failed post again?
No. Fix the cause, then open the post from Content → Posting Errors and use Duplicate Failed to send the failed part again. See The Posting Errors page.
I keep seeing "An unexpected error occurred while processing your request." What now?
Check the common causes first. If none fits, reload the page, try again, and if it keeps happening, contact support with what you were doing and when.