Schedule post(s) for later
schedule_postSchedule one or more text posts to be published at a future time on Threads, X (Twitter), and/or LinkedIn accounts. Threads posts can carry images from the media library via mediaIds on the first post: one image, or 2–20 images as a carousel; all target accounts must then be Threads accounts. TikTok Business supports one public video for one account with one caption: video takes an uploaded mediaId, requestId UUID, and privacyLevel PUBLIC_TO_EVERYONE. get_publish_status tracks TikTok publishing by the returned jobId, and repeating a request with the same requestId returns the same job. Instagram takes instagram with one account, a requestId UUID, FEED (1–20 media items), REELS (1 item), or STORIES (1 item), and uploaded mediaIds; it cannot be combined with posts or video. Caption is optional except that STORIES rejects it, and shareToFeed is REELS-only. Instagram publishing is asynchronous. YouTube takes youtube with one account, a requestId UUID, an uploaded video mediaId, a title (1–100 characters), optional description, privacyStatus (public, unlisted, or private), and optional madeForKids; it cannot be combined with posts, video, or instagram. get_publish_status tracks the returned jobId, and repeating a request with the same requestId returns the same job. A Facebook Page takes facebook with one account, a requestId UUID, and explicit FEED, REELS, or STORY content type. FEED accepts text and up to 10 uploaded media items, REELS requires one video, and STORY requires one image or video and rejects message. Facebook scheduling is asynchronous. Multiple posts are chained as a thread on Threads/X at the scheduled time. LinkedIn is single-caption only — it does not support chaining, so sending more than one post to a LinkedIn account is rejected. Supports up to 5 accounts at once. For X, links (http://, https://, www., and bare domains such as foo.io/path) are automatically removed from posts[0] before saving the schedule. Replies in posts[1+] and other platforms keep their links. Character limits apply after removal; an empty first X post rejects the entire request with VALIDATION_ERROR. Character limits: Threads 500, X 280 (25000 for Premium), LinkedIn 3000. The target workspace is determined automatically from accountIds (each account belongs to exactly one workspace); all accountIds must belong to the same workspace. cancel_scheduled_post cancels a schedule until processing starts; media schedules cannot be canceled once processing begins.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"accountIds": "<accountIds>",
"scheduledAt": "<scheduledAt>"
},
"name": "schedule_post"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| posts | No | Text posts to schedule. Required for text and TikTok modes; omit for Instagram, YouTube, or Facebook. If multiple, they are published as a thread chain at the scheduled time. Max 25 items. For X, links (http://, https://, www., and bare domains such as foo.io/path) are automatically removed from posts[0] before saving the schedule. Replies in posts[1+] and other platforms keep their links. Character limits apply after removal; an empty first X post rejects the entire request with VALIDATION_ERROR. | |
| video | No | TikTok Business video: an uploaded mediaId and requestId UUID, one account and one caption, and explicit PUBLIC_TO_EVERYONE privacy. | |
| youtube | No | YouTube video: one account, a requestId UUID, an uploaded video mediaId, a title, optional description, privacyStatus public/unlisted/private, and optional madeForKids. Cannot be combined with posts, video, or instagram. | |
| No | Facebook Page post: one account, a requestId UUID, explicit FEED/REELS/STORY content type, optional FEED/REELS message, and uploaded media IDs. STORY does not accept message. | ||
| mediaIds | No | Threads only: image mediaIds from the media library (list_media with mediaType IMAGE, or uploaded images) attached to posts[0]. One image makes an image post; 2–20 images make a carousel. Replies in posts[1+] stay text. Every accountId must be a Threads account. Cannot be combined with video, instagram, youtube, or facebook. | |
| timezone | No | IANA timezone name (e.g. 'Asia/Seoul', 'America/New_York'). If omitted, the workspace default timezone is used. | |
| No | Instagram media post: one account, a requestId UUID, FEED/REELS/STORIES content type, and 1–20 uploaded media IDs. Cannot be combined with posts or video. | ||
| accountIds | Yes | Account IDs to schedule the post for (from list_accounts). 1–5 accounts. Each must be a UUID. | |
| scheduledAt | Yes | Future ISO 8601 timestamp with timezone offset at which to publish (e.g. '2026-06-15T09:00:00+09:00'). Must be in the future. list_workspaces returns each workspace's timezone for converting local times such as 'tomorrow 10am'. | |
| workspaceId | No | Optional. The target workspace is determined automatically from accountIds; when given, it must match the accounts' workspace. |