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. 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 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. 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. 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.

Authorization

apiKey

AuthorizationBearer <token>

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; include instagram for one Instagram media post; include youtube for one YouTube video; or include facebook for one Facebook Page post. TikTok uses posts and video together. Instagram, YouTube, and Facebook are self-contained modes and cannot be combined with other write modes.

accountIds?array<>

One to five text targets, or exactly one TikTok, Instagram, YouTube, or Facebook account for media publishing.

Items1 <= items <= 5

posts*array<>

Text chain, or exactly one non-empty caption when video is present. TikTok captions allow up to 2,200 UTF-16 code units. LinkedIn also requires one post. For X, links are automatically removed from posts[0] before publishing or saving a schedule: 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) and all text for other platforms are preserved. 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 publishing or scheduling occurs.

Items1 <= items <= 25

video?

Publish one video from the same workspace's active media library to one account connected through TikTok for Business Developers. Confirm a new upload before using its mediaId. Photo publishing and arbitrary video URLs are not supported. The request must contain exactly one accountId and one caption in posts.

instagram?||

Publish to one Instagram professional account. Choose exactly one content type contract below and do not combine this object with posts or video.

youtube?

Publish one video from the same workspace's active media library to one connected YouTube channel. Confirm a new upload before using its mediaId. Videos may be up to 500 MiB and 12 hours long. The request must contain exactly one accountId and must not include posts, video, or instagram. A first comment is not supported.

facebook?|||

Publish asynchronously to one Facebook Page. Choose exactly one explicit content type and do not combine this object with posts, video, instagram, or youtube. requestId is unique within the workspace; reuse it only for the same unchanged request.

scheduledAt*string

Future ISO 8601 timestamp with an offset, within 360 days. Replace the example timestamp with your own future publishing time.

Formatdate-time

timezone?string

IANA timezone (e.g. Asia/Seoul). Uses the workspace default, or UTC if unavailable, when omitted.

Schedule a post

Authorization

Request Body

Response Body

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

Schedule a post

Text scheduled

TikTok scheduled

Authorization

Request Body

Response Body

200application/json

202application/json

409application/json

422application/json

502application/json

503application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`