Support & FAQ
Answers to common questions about post failures, API authentication, rate limits, uploads, and account permissions in ReplyNodes
Support & FAQ
Short answers to common ReplyNodes questions, grouped by topic. Each entry stands on its own — jump straight to the one you need.
Posting & Publishing
What do the post statuses (Draft, Queue, Published, Error) mean?
Every post in ReplyNodes has one of four states: Draft (saved but not scheduled), Queue (scheduled and waiting for its publish time), Published (successfully sent to the channel), or Error (the last publish attempt failed). You can see a post's state in the calendar view.
Why did my post fail to publish?
A post that failed to publish shows an Error state and appears in the calendar with a red ring around it — hover over it to see the specific error message. Common causes:
- The connected channel needs to be reconnected (its access token expired or was revoked).
- The channel was disabled.
- The social platform rejected the content (for example, it failed the platform's own validation rules).
- Your organization has no active subscription, if billing is enabled on your workspace.
My post failed with "the channel needs to be reconnected" — what do I do?
This means ReplyNodes tried to refresh your channel's access token and the social platform rejected it (the token was revoked, expired, or the connection was removed on the platform's side). Go to your channel/integrations list, reconnect the affected channel by going through its login flow again, then reschedule or resave the post. ReplyNodes also sends an in-app notification and an email when this happens.
My post failed because the channel is "disabled" — what does that mean?
The channel was turned off in your ReplyNodes workspace (for example, by a team member) and ReplyNodes will not attempt to publish to it. Re-enable the channel in your integrations list, then reschedule or resave the post.
Will I be notified if a post fails to publish?
Yes. ReplyNodes creates an in-app notification for publish failures (channel needs reconnecting, channel disabled, or the platform rejected the content), and in those cases it also sends an email to your organization. Successful publishes generate an in-app + email notification too.
Is there a way to retry a failed post?
There is no dedicated "retry" button for a failed post today. Reschedule or resave the post (moving it back into the Queue state) to trigger a new publish attempt — first make sure the underlying cause (a disconnected channel, a disabled channel, or invalid content) has been fixed, or the retry will fail the same way.
My post is still sitting in "Queue" past its scheduled time — is it stuck?
Not necessarily. In addition to the normal publish attempt at the scheduled time, ReplyNodes runs an hourly safety-net check that looks for posts still in Queue whose scheduled time has already passed (within about the last two days) and re-triggers them, as long as the channel isn't disabled or waiting to be reconnected. If the channel needs reconnecting or is disabled, fix that first — the safety-net job skips posts on channels in those states.
Public API & Authentication
How do I authenticate with the Public API?
Send your API key as the raw value of the Authorization header — there is no Bearer prefix:
curl -H "Authorization: YOUR_API_KEY" https://api.replynodes.com/public/v1/postsGet your API key from Settings → Public API → Access in the ReplyNodes dashboard (visible only to Admin/Superadmin roles on the organization). See the Public API Reference for full details.
I'm getting a 401 "No API Key found" error — what's wrong?
Your request is missing the Authorization header entirely. Add Authorization: YOUR_API_KEY (or Authorization: pos_YOUR_OAUTH_TOKEN for an OAuth app token) to the request.
I'm getting a 401 "Invalid API key" or "Invalid OAuth token" error — what's wrong?
The value you sent in the Authorization header doesn't match any active key or token. Double-check you copied the whole key with no extra whitespace, and confirm it hasn't been rotated or revoked — rotating a key in Settings → Public API → Access (or revoking an OAuth app token in Settings → Developer) invalidates the old value immediately.
What does "No subscription found" mean from the Public API?
Your organization doesn't currently have an active subscription, and billing is enabled on this ReplyNodes instance. This check runs for both personal API keys and OAuth app tokens. Resolve it by making sure your organization has an active plan.
Do OAuth app tokens work differently from personal API keys?
No — once issued, an OAuth token (prefixed pos_) is used in the same Authorization header and is validated the same way as a personal API key; it just authenticates as the user/organization that authorized the OAuth app rather than as you directly. See OAuth Applications for how to create and manage them.
Rate Limits & Plan Limits
Is the Public API rate-limited?
Only the endpoint used to create posts (POST /public/v1/posts) is rate-limited. It's capped per organization to a fixed number of requests per hour (90 by default). Other Public API endpoints (listing posts, integrations, uploads, analytics, etc.) don't share this limit. If you're building high-volume automation against post creation specifically, batch multiple posts into fewer requests where possible.
Why am I getting a 402 "Payment Required" style error?
A 402 response means you've hit a plan limit rather than an authentication problem — for example, the number of connected channels, posts per month, videos per month, or team members allowed on your current plan. The response identifies which limit was hit. Upgrade your plan, or free up capacity (for example, disconnect an unused channel) to continue.
Why can't I invite another team member or perform an admin action?
Team management actions (inviting/removing teammates) require the Admin or Superadmin role on the organization, and are also subject to your plan's team-seat limit. If you're not an Admin/Superadmin, or your plan's team member limit has been reached, the action is blocked — ask an organization Admin to make the change, or upgrade your plan for more seats.
Media & Uploads
Why was my media upload rejected?
ReplyNodes validates the actual file content (not just the filename or extension) against a fixed allow-list: JPEG, PNG, GIF, WebP, AVIF, BMP, and TIFF for images, and MP4 for video. A file with a disguised or unsupported format is rejected with "Unsupported file type." Renaming a file to a supported extension won't help if its actual content isn't one of these formats.
What's the maximum file size for uploads?
Images are capped at 10 MB and videos at 1 GB. Uploads over the limit are rejected with a "File size exceeds the maximum allowed size" error. Compress or resize the file and try again.
MCP (Model Context Protocol)
I'm having trouble connecting to the ReplyNodes MCP server
MCP connection, authentication, and tool-discovery issues (like "Connection refused," "Authentication failed," or "Tool not found") are covered in the MCP Troubleshooting section. MCP uses the same API key/OAuth token authentication as the Public API, so the authentication answers above apply there too.
Getting More Help
This FAQ didn't answer my question — where else can I look?
Check the Public API Reference, OAuth Applications, and MCP Integration guides for endpoint- and integration-specific detail. For account-specific issues (billing, plan limits, access problems) that aren't covered here, reach out through whatever contact or chat option is available in your ReplyNodes workspace, or contact your organization's admin.