> ## Documentation Index
> Fetch the complete documentation index at: https://docs.postqueen.ai/llms.txt
> Use this file to discover all available pages before exploring further.
> ## Agent Instructions
> PostQueen's hosted API is https://api.postqueen.ai. The public API base is https://api.postqueen.ai/public/v1 and takes the raw API key in the Authorization header, with no Bearer prefix.
> The MCP server for posting is https://api.postqueen.ai/mcp/YOUR_API_KEY (or /mcp with Authorization: Bearer YOUR_API_KEY). docs.postqueen.ai/mcp only searches these docs and cannot post.
> The API key is under Connections > API Keys in the app, and only workspace admins can see it.
# Common errors
> The messages PostQueen shows when you sign in, connect a channel, post, upload, pay or call the API: what each one means and what to do.
Find the message you saw, then do what its row says. Messages are quoted the way PostQueen shows them. Each group links to the page that covers the topic in full.
A post that was scheduled and then failed has its own page: [A post did not go out](/troubleshooting/post-failed).
## Signing in
| Message | What to do |
| ------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| “Invalid user name or password” | Check the email and the password. To reset the password, choose **Forgot password?**, or choose **Email me a sign-in code** to sign in without it. |
| “Invalid or expired code” | The sign-in code is wrong or more than 10 minutes old. Ask for a new one with **Email me a sign-in code**. |
| “Too many attempts, request a new code” | The code was typed wrong too many times. Ask for a new one. |
| “Too many requests, please try again later” | Too many tries in a short time. Wait a few minutes, then try again. |
| “Your account is not activated yet. Please check your email for the activation link.” | Open the link in the email PostQueen sent when you signed up. Lost it? Choose **Resend Activation Email**. |
| The activation page says the link "is no longer valid" | The link is more than 7 days old, or the account is already active. Try to sign in; if PostQueen asks again, resend the activation email. |
| “Your password reset link has expired. Please try again.” | A reset link works for 20 minutes. Choose **Forgot password?** again and use the new link at once. |
| Signed out on your other devices | Changing your password signs out every session from before the change. Sign in again with the new password. |
## Connecting a channel
| Message | What to do |
| ------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| “Could not add provider.” with “Internal server error” under it | Usually the network's sign-in took more than an hour, or its page was reloaded or opened twice. Start again from **Add Channel** and finish the sign-in in one go. |
| “Not enough scopes, when choosing a provider, please add all the scopes” | A permission was left unticked on the network's screen. Connect again and approve every permission it asks for. |
| “Authentication failed” | The network refused the sign-in. Check that you can sign in to the account on the network, then connect again. |
| “X unlocks after your trial” | X connects once your paid plan starts. Choose **End free trial to unlock X**, or wait: [Free trial](/cloud/trial). |
| “This social channel was connected previously to another PostQueen account.” | During the free trial, an account that another PostQueen account connected before is refused. Choose **Fast track - Charge me now** to end the trial, or connect another account. |
| “You have reached the maximum number of channels for your subscription. Please upgrade your subscription to add more channels.” | You are at your plan's channel limit, when you connect a channel or choose **Enable Channel**. Disabled channels count when you connect a new one, so delete a channel you no longer need, or choose **Move to billing** and pick a bigger plan: [Plans and limits](/cloud/plans). |
| “Could not connect to the platform” | Try again. If it keeps failing, [contact support](/support). |
| A network has no way to connect | It is marked Soon and cannot be connected yet: [All channels](/channels/overview). |
A channel that stopped publishing shows **Needs reconnecting**: [The channel needs reconnecting](/troubleshooting/post-failed#the-channel-needs-reconnecting). Each network's own page lists the messages that network gives.
## Writing a post
In the composer, most messages start with the channel's name, so you know which version to fix.
| Message | What to do |
| --------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------ |
| “Your post should have at least one character or one image.” | Add text or media to that channel's version. |
| “Please fix your settings”, or the setting's own message | The composer opens that channel's settings. Fill in the field it points to. |
| “post is too long, please fix it” | Shorten the text on that channel's tab. Each network's page has its limit. |
| A media rule, such as "Should have at least one media" or "Item must be a video" | That network needs a certain kind of media. Its page lists what it accepts. |
| “Could not save the post, please try again” | Check that each channel's required settings are filled in, then try again. |
| “Could not check the post, please try again” | Try again in a moment. |
| “None of your channels can be posted to right now. They are disconnected, disabled, or still finishing setup. Check Channels, or your plan, to continue.” | Reconnect or enable a channel on **Channels**, or check your plan on **Billing**. |
| The buttons read **Select Channels** | Pick at least one channel at the top of the composer. |
| “Could not move this post, please try again” | The post goes back to its old time. Try again, or open it and change the date there. |
[Create a post](/using/create-a-post) covers the composer.
## Media
| Message | What to do |
| -------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| “File is too large. Maximum size allowed is 1GB.” | Every file can be up to 1 GB. Compress the video, or upload a smaller file. |
| “Upload size limit exceeded. Maximum 1 GB per upload session.” | Add fewer files at a time. |
| A file type "is not allowed" | The app takes JPG, PNG, GIF and WebP images and MP4 and MOV videos, and the message lists the types that place accepts. A MOV is converted to MP4 after upload. |
| “The video could not be converted.” | Export the video as MP4 yourself and upload it again. |
| “The video could not be optimized and was kept as it came.” | Nothing to do: the MP4 is used as you uploaded it. |
| “Could not upload” and a file name | The upload stopped. Check your connection and upload the file again. |
| “Failed to fetch URL” | Uploading from a link needs a public HTTPS link with no sign-in in front of it. Download the file and upload it instead. |
[Media library](/using/media-library) covers uploading. Each network publishes less than 1 GB: its page has its own limits.
## Plan and billing
| Message | What to do |
| ------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| “You have reached the maximum number of posts for your subscription. Please upgrade your subscription to add more posts.” | The workspace has no active plan, so it cannot post. Choose a plan on **Billing**. No plan has a monthly post limit. |
| “Your plan is at its webhook limit. Remove one or upgrade to add another.” | Delete a webhook, or move to a bigger plan. |
| “Your subscription does not include team members. Please upgrade your subscription to invite your team.” | Team members start on Growth. Choose **Upgrade plan**. |
| “You are out of AI credits for this month.” | Credits reset each month on the day your plan started. Wait, or move to a bigger plan. |
| “You have reached the maximum number of generated videos for your subscription. Please upgrade your subscription to generate more videos.” | Your AI videos for this month are used up. They reset on the day your plan started. Wait, or choose **Move to billing** for a bigger plan: [AI images and video](/using/ai-images-and-video). |
| “AI Copilot unlocks after your trial” | The AI Copilot starts with your paid plan. Choose **End free trial to unlock AI Copilot**, or wait: [Free trial](/cloud/trial). |
| “You are currently on trial, in order to use the feature you must finish the trial” | A Seedance video waits for the paid plan. Choose **Finish the trial, charge me now**, or close the dialog and make the video with **Image Text Slides**. |
| “We could not charge your credit card” | Choose **Update payment method** and fix the card in the billing portal. |
| “Only a workspace admin can do this. Please ask an admin of this workspace.” | Billing, the team and the API key are for Admins and Super Admins. Ask one of them. |
[Plans and limits](/cloud/plans), [Free trial](/cloud/trial) and [Manage your subscription](/cloud/subscription) have the details.
## API, CLI and agents
| Message | What to do |
| ------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `No API Key found` (401) | Send the key in the `Authorization` header. |
| `Invalid API key` (401) | The key is wrong, was rotated, or was sent with `Bearer` in front. Copy it again from **Connections > API Keys** and send it as it is. |
| `No subscription found` (401) | The workspace has no trial or plan. Start one on **Billing**. |
| `ThrottlerException: Too Many Requests` (429) | You reached an hourly limit, such as 30 requests to create posts through the public API. Wait the seconds in `Retry-After`, and put several channels in one request. See [Rate limits](/public-api/limits-and-errors#rate-limits). |
| A setting path, such as `posts.0.settings.who_can_reply_post must be one of the following values: ...` (400) | A required setting is missing or wrong. The channel's settings list says what it takes: [Integration settings](/public-api/integrations/settings). |
| The channel name, a colon and a reason, such as `My Bluesky: post is too long, please fix it` (400) | Moving a draft to scheduled runs the same checks as creating a post. Fix the draft for that channel, then schedule it again. |
| `Cannot change status of a published or errored post` (400) | A failed post cannot be scheduled again by status. Create it again, or send it again from the calendar: [Send the post again](/troubleshooting/post-failed#send-the-post-again). |
| `Post not found` (404) | The ID is wrong, or the post was already deleted. |
| `This video is not available in trial mode` (406) | Seedance videos wait for the paid plan. Use `image-text-slides`, or end the trial on **Billing**: [Generate a video](/public-api/videos/generate). |
| “This workspace has no active plan, or no posts left on its plan this month.” | Your agent's schedule tool was refused. Choose or renew a plan on **Billing**, then ask again. |
| “This channel needs to be reconnected before you can schedule posts. Please reconnect it from Channels.” | Reconnect the channel on **Channels**, then ask your agent again. |
[Limits and errors](/public-api/limits-and-errors) lists the API's status codes and error bodies, and [Agent troubleshooting](/agents/troubleshooting) the messages of MCP tools and the CLI.
## Still stuck?
Bugs PostQueen knows about, with a way around each one.
How to reach a person, and what to put in your message.