Schedule a post
Choose a future time to publish text or media to a connected account.
curl -X POST "https://example.com/api/v1/scheduled-posts" \ -H "Content-Type: application/json" \ -d '{ "accountIds": [ "11111111-1111-4111-8111-111111111111" ], "posts": [ "Hello from the Posteady API!" ], "scheduledAt": "2026-10-01T00:00:00Z", "timezone": "Asia/Seoul" }'{ "results": [ { "accountId": "11111111-1111-4111-8111-111111111111", "provider": "threads", "username": "your_brand", "success": true, "scheduledPostIds": [ "55555555-5555-4555-8555-555555555555" ], "scheduledAt": "2026-10-01T00:00:00Z" } ], "summary": { "succeeded": 1, "failed": 0 }}Schedule text posts for Threads, X, or LinkedIn, one public TikTok video, an Instagram FEED, REELS, or STORIES post, one YouTube video, or a Facebook Page FEED, REELS, or STORY post for an account with capabilities.schedulePosts=true. Threads, X, and LinkedIn text schedules accept mediaIds for media on the first post, or mediaIdsByPost for media on each post, as in immediate publishing, including Threads, X, and LinkedIn videos, and linkedinOptions.document for a LinkedIn document post. Media requests accept the same input as immediate publishing and return scheduledPostIds, jobId, and status. Use scheduledPostIds to cancel and jobId to check progress. The time must be in the future. Facebook returns HTTP 202 while the job is active and HTTP 200 for every terminal replay; failed, canceled, and unknown results keep success=false.
For X, links are automatically removed from the first post (posts[0]) when this request is accepted, before saving the schedule. This covers http://, https://, www., and bare domains such as foo.com or foo.io/path, including paths, query strings, and fragments. Links in replies (posts[1] onward) remain, and other platforms receive the original text. To keep the links in the first post, set xOptions.keepFirstPostLink to true; if X recognizes a kept link, the schedule is charged as a post with a link. X character limits are checked after removal. If the first X post becomes empty or whitespace-only, the entire request fails with VALIDATION_ERROR (HTTP 422) before any schedule is created. Existing schedules and later edits in the web editor are not processed by this rule. See the X guide for examples.
Scheduling to X uses the organization's credits when the schedule is created: 2 credits for each post and 20 credits for each post that contains a link, with each post in a thread counted separately. If the organization doesn't have enough credits, the request fails with INSUFFICIENT_CREDITS (HTTP 402) and nothing is scheduled. Canceling an X schedule refunds its credits, and so does a scheduled X post that fails to publish.
Authorization
apiKey In: header
Request body
application/json
TypeScript definitions
Use the request body type in TypeScript.
Publish text to Threads, X, or LinkedIn; include video for one public TikTok video or tiktokPhoto for one TikTok photo post; include instagram for one Instagram media post; include youtube for one YouTube video; or include facebook for one Facebook Page post. TikTok uses posts with video or tiktokPhoto. Instagram, YouTube, and Facebook are self-contained modes and cannot be combined with other write modes. A Threads, X, or LinkedIn text request can add mediaIds to attach library images to the first post (Threads, X, and LinkedIn also take videos), or mediaIdsByPost to attach media to each post of a Threads or X thread. A LinkedIn post can carry a library document instead, with linkedinOptions.document. Text requests can add threadsOptions, xOptions, and linkedinOptions. Each applies to the accounts of that platform in accountIds, and the request fails if accountIds has none.
Publish text to Threads, X, or LinkedIn; include video for one public TikTok video or tiktokPhoto for one TikTok photo post; include instagram for one Instagram media post; include youtube for one YouTube video; or include facebook for one Facebook Page post. TikTok uses posts with video or tiktokPhoto. Instagram, YouTube, and Facebook are self-contained modes and cannot be combined with other write modes. A Threads, X, or LinkedIn text request can add mediaIds to attach library images to the first post (Threads, X, and LinkedIn also take videos), or mediaIdsByPost to attach media to each post of a Threads or X thread. A LinkedIn post can carry a library document instead, with linkedinOptions.document. Text requests can add threadsOptions, xOptions, and linkedinOptions. Each applies to the accounts of that platform in accountIds, and the request fails if accountIds has none.
Response body
application/json
application/json
application/json
application/json
application/json
application/json