post_publish
Publish a post to specified social media profiles. Supports text, media attachments, scheduling, drafts, threads, and platform-specific customization.
Instructions
Publish a post to specified social media profiles. Supports text content, media attachments, scheduling, drafts, threads (X and Threads only), and platform-specific customization via the 'platforms' parameter.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| draft | No | If true, creates a draft post that won't publish automatically | |
| media | No | Optional array of media URLs or local file paths (images or videos). File paths can be absolute (/path/to/file.jpg), relative (./image.png), or use ~ for home directory (~/Pictures/photo.jpg) | |
| thread | No | Optional array of thread child posts (supported on X/Twitter and Threads only). The parent post is published first, then each child is published as a reply in order. | |
| content | Yes | Post content text (caption/description) | |
| profiles | Yes | Array of profile IDs (hashids) or platform names (e.g., 'linkedin', 'instagram', 'twitter'). When using platform names, posts to the first connected profile for that platform. | |
| queue_id | No | Optional queue ID to add the post to. The queue will automatically assign a timeslot. Do not use together with 'schedule'. | |
| schedule | No | Optional ISO 8601 scheduled time (e.g., '2024-12-31T23:59:59Z') | |
| platforms | No | Platform-specific parameters. Keys are platform names, values are parameter objects. Use this to add collaborators, set video titles, privacy settings, etc. | |
| queue_priority | No | Optional priority when adding to a queue (default: medium). Higher priority posts get earlier timeslots. | |
| idempotency_key | No | Optional idempotency key for request deduplication | |
| require_confirmation | No | If true, return summary without publishing (dry run) |