Post Schedule
post_scheduleSchedules new or draft social media posts for publication at a chosen time across selected channels, including approval waits when required.
Instructions
Schedule a social media post for a time: a new post from content and channelIds, or an existing draft (postId; content, channelIds or targets and media then replace its text, channels and media). It is published at that time unless someone changes it in FirstReply. When the organization requires approval, a member's post waits for a manager (status PENDING_APPROVAL).
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": {
"organizationId": "<organizationId>",
"scheduledAt": "<scheduledAt>"
},
"name": "post_schedule"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| media | No | Images or videos of the post, in order, uploaded with post_media_upload. Instagram, TikTok and YouTube need media; what each channel accepts is checked when the post is saved. | |
| postId | No | An existing post to schedule. Omit to create a new post. | |
| content | No | The text of the post. Required for a new post. | |
| targets | No | The channels to post to with their own text or platform settings, instead of channelIds; only channels with publishingEnabled (see channel_list). Settings by channel type: INSTAGRAM: postType FEED (default), REELS or STORY; shareToFeed (Reels, default true). X: threadParts, the texts of the posts after the first one of a thread. YOUTUBE (one video): title (required, up to 100 characters), madeForKids (required, true or false), format VIDEO or SHORT, privacyStatus public, unlisted or private, categoryId, containsSyntheticMedia. The text is the description. TIKTOK: privacyLevel (required, one the account offers, see channel_tiktok_creator_info), allowComment, allowDuet, allowStitch, commercialContent with yourBrand and/or brandedContent, title (photo posts), and musicUsageConfirmed true (required) plus brandedContentPolicyConfirmed true for branded content: set these two only after the user agreed to TikTok's Music Usage Confirmation and Branded Content Policy. GOOGLE_BUSINESS: topicType STANDARD, EVENT or OFFER; actionType NONE, BOOK, ORDER, SHOP, LEARN_MORE, SIGN_UP or CALL with actionUrl; events and offers: eventTitle, startDate and endDate (YYYY-MM-DD), startTime and endTime (HH:mm); offers: couponCode, redeemUrl, terms. MASTODON: visibility public, unlisted or private; spoilerText (content warning). TELEGRAM: silent (no notification). | |
| timezone | No | IANA time zone the post is planned in, e.g. Europe/Vienna. Shown in the calendar. | |
| channelIds | No | Ids of the channels to post to; only channels with publishingEnabled (see channel_list). Required for a new post, unless targets are given. | |
| scheduledAt | Yes | When to publish: ISO 8601 date-time with UTC offset, e.g. 2026-11-10T10:00:00+01:00. At least 10 minutes from now. | |
| organizationId | Yes | The organization id. Use organization_list to find it. |