Create, schedule or publish a post
create_postCreate a post for one or more social accounts. Leave scheduledFor and publishNow empty to save a draft (optionally with a suggestedFor date the person will see when reviewing it); set scheduledFor to schedule; set publishNow to publish immediately. If the organization requires approval and the connected person cannot approve, a scheduled or immediate post is created PENDING APPROVAL instead (status PENDING_APPROVAL) and goes out once someone approves it. Validates each network before sending, so a rejected post comes back as an explained error instead of a silent failure. Note for comment-to-DM automations set to "next post": only a real publication claims them — a draft never does, and a scheduled post only when its time arrives and it actually goes out.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| altText | No | Accessibility alt text per image, keyed by its URL in mediaUrls: {"https://…/a.jpg":"A dog on a red sofa"}. Applied on Instagram feed, Facebook, Threads, X (max 1000), LinkedIn, Bluesky and Pinterest (max 500); ignored elsewhere. Write it for every image you attach — a post without alt text is unreadable to screen readers, and several networks rank it. | |
| content | Yes | Main copy of the post. | |
| useQueue | No | Schedule in the next free slot of the organization's posting queue. | |
| mediaUrls | No | Public https URLs of images/videos to attach. THE ORDER MATTERS: it is the carousel order the reader swipes through, and the first one is the cover — the image that shows in the profile grid. Get them from generate_image, generate_video (via get_media_job), upload_media (for a file on the user's machine), import_media (for a url that is already public) or list_library_media. | |
| accountIds | Yes | Ignix account ids from list_accounts. | |
| publishNow | No | Publish immediately. | |
| aiGenerated | No | Set true only when the person wants the AI label: the post goes out with each network's AI label (Instagram, X, YouTube, TikTok video). It is their choice; when the media was generated or altered with AI (generated people, a person put into a video from a photo, a synthetic voice), ask them once whether they want it. | |
| workspaceId | No | Workspace to work on (an id from list_workspaces). Not needed when this connection is tied to one workspace, or when you pass an account: the account's workspace is used. | |
| scheduledFor | No | When to publish. ISO 8601. Without a timezone ('2026-08-05T14:00') it is the organization's local time. | |
| suggestedFor | No | Drafts only: a PROPOSED date (ISO 8601) shown when the person reviews the draft. It does not schedule anything; ignored if scheduledFor or publishNow is set. | |
| idempotencyKey | No | Optional. A unique id for this action (16-128 chars: letters, digits, _ : . -). If you are unsure whether a call went through (timeout, network error), repeat it with the SAME idempotencyKey and the same arguments: you get the original result and nothing is done twice. | |
| networkOptions | No | Network-specific options keyed by platform: first comment, collaborators, cover image, privacy, board, flair, TikTok consent… e.g. {"instagram":{"firstComment":"…","collaborators":"user1,user2"},"youtube":{"visibility":"public"},"pinterest":{"boardId":"…"}}. Call get_network_options for the EXACT list each network accepts, with types, accepted values and which ones are required. | |
| perNetworkText | No | Different copy per network, keyed by platform, e.g. {"x":"short version","linkedin":"long version"}. Networks not listed use the main content. |