Schedule a Hive post
schedule_postIdempotent
Put a post in Hive’s queue for a future time, with every composer option. Your AI asks you before this runs; with Hive approvals on, Hive asks again inside Hive, because it will be published publicly. Hive checks every target network before it writes anything, so a post a network would reject is refused here instead of failing later.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cover | No | The composer cover plan. Omit to keep the existing cover; null removes it. | |
| media | No | The photos and videos on the post, in order. | |
| runAt | Yes | When to publish, as an ISO date in the future. | |
| title | No | Shared title. Mainly YouTube. | |
| postId | No | An existing Hive draft to schedule. Leave it out to create and schedule in one step. | |
| tagIds | No | Internal tag ids. | |
| caption | No | Shared caption. | |
| privacy | No | Shared privacy, overridden by per-network options when supplied. | |
| hashtags | No | Hashtags appended per network rules. | |
| tagNames | No | Internal tag names. Unknown names are refused with the list of tags that exist. | |
| assigneeId | No | The teammate asked to approve this post. | |
| channelIds | No | The connected Hive accounts this post goes to. | |
| recurrence | No | A repeat pattern. Supplying it creates a repeating series whose first post is the next occurrence. | |
| campaignIds | No | Campaign ids. | |
| perPlatform | No | Per-network options keyed by network (instagram, facebook, tiktok, youtube, linkedin, x, threads, pinterest, snapchat, bluesky, mastodon, whatsapp, telegram). Each value takes what Hive's composer takes, for example postType (post, reel, story), caption, title, privacy, firstComment, igLocationId, igAltText, igCollaborators, coverUrl, threadsReplyControl, youtubeFormat, tiktokPrivacyLevel. Anything omitted falls back to the shared values. | |
| firstComment | No | A first comment posted under the post where the network supports it. | |
| linkTracking | No | Whether Hive rewrites links for click tracking. Defaults to the workspace setting. | |
| approvalToken | No | Single-use token returned by Hive after the owner approves this exact action. | |
| campaignNames | No | Campaign names. Unknown names are refused with the list of campaigns that exist. | |
| hashtagGroupId | No | A saved hashtag group. Its hashtags are merged with any you pass. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. | |
| expectedVersion | No | Required with postId: the exact version returned by read_post for the content being approved. Changed content requires a fresh review. | |
| approvalWorkflowId | No | The approval workflow to run instead of the workspace default. |