Posteady
Posteady Docs
User guideDeveloper guidesAPI referenceMCP

Plans, usage, and rate limits

Understand access requirements and shared API limits.

Plan requirement

REST and MCP require Creator or above. An ineligible workspace returns 403 PLAN_REQUIRED. Your current workspace role and permissions still apply on a paid plan.

Rate limits

REST keys and MCP tokens each allow 50 requests per minute with a 60-second fixed window. Exceeding that rate returns 429 RATE_LIMITED. Space out requests and status polling, then retry once the window resets; do not immediately loop on a 429 response.

Organization usage

API/MCP usage is counted at the organization level. The monthly allowance depends on the plan and billing cycle; review API usage in Posteady settings. A request that exceeds an enforced monthly allowance returns 429 QUOTA_EXCEEDED. The allowance resets at the start of the next billing cycle, not after the one-minute rate-limit window.

The same error code can also indicate media storage exhaustion. Read the error message to distinguish request usage from storage. Reserved upload bytes count toward storage even before upload confirmation. Replays and polling are still requests and can contribute to usage.

Per-request limits

ResourceLimit
Text publish/schedule1–5 accounts; 1–25 posts for Threads/X, one for LinkedIn
TikTok/Instagram/YouTube/Facebook publish/scheduleExactly one account
RepostOne supported account and one native post ID
SchedulesFuture timestamp within 360 days
Published postsLast 90 days by default; since–until up to 90 days; limit 1–100, default 20; offset 0–9,900
Account analyticsLast 90 days by default; since–until up to 90 days
Comment replyText only; Instagram 2,200 characters, YouTube 10,000, Threads 500, X 280 or 25,000 for X Premium accounts (Korean, Chinese, Japanese characters and emoji count as 2), LinkedIn 1,250, Facebook 8,000; TikTok applies its own limit
Media listlimit 1–100, default 20; offset 0–10,000
JPEG upload8 MiB
PNG/WebP upload20 MiB, stored as JPEG
MP4/QuickTime upload4 GiB in the shared library (over 2 GiB with uploadMethod: multipart)
Upload URLPUT within 300 seconds
Upload confirmationWithin 24 hours of reservation

Platform-specific character, duration, and file-size limits are documented in the platform guides. Uploading to the shared library does not guarantee acceptance by a platform. For example, YouTube publishing accepts at most 2 GiB, while Instagram and Facebook accept videos up to 1 GiB.

Platform allowances

Each social platform can also enforce its own publishing or upload limits. Instagram's checks can cause an asynchronous job to fail; YouTube daily upload or rate-limit failures can appear as PUBLISH_QUOTA_EXCEEDED. Inspect the job error in addition to the HTTP response. See Publishing lifecycle.

Blocked accounts

Blocked users receive 403 BLOCKED. See Errors and partial failures for the common response format and recovery steps.

On this page