distribution

Target platforms (array). Each must have active OAuth — check list_connected_accounts first. Values: youtube, tiktok, instagram, twitter, linkedin, facebook, threads, bluesky.

URL of the media file to post. Any public HTTPS URL works — including ephemeral generator URLs (Replicate, OpenAI, DALL-E). The server persists non-R2 URLs into R2 before posting so scheduled posts and byte-upload platforms (X, LinkedIn, YouTube, Bluesky) do not 404 when the source URL expires. Set auto_rehost=false to skip. Not needed if media_urls, r2_key, or job_id is provided.

Array of 2-10 image URLs for carousel posts. Same rehosting rules as media_url — ephemeral URLs are persisted automatically. Use with media_type=CAROUSEL_ALBUM.

R2 object key from upload_media. Signed on demand at post time — survives scheduling delays. Alternative to media_url.

Array of R2 object keys for carousel posts. Each is signed on demand. Alternative to media_urls.

Async job ID from generate_image/generate_video. Resolves the completed job's R2 key and signs it. Alternative to media_url/r2_key.

Array of async job IDs for carousel posts. Each resolved to its R2 key. Alternative to media_urls/r2_keys.

Platform-specific metadata. Example: {"tiktok":{"privacy_status":"PUBLIC_TO_EVERYONE"}, "youtube":{"title":"My Video"}}

Media type. Set to CAROUSEL_ALBUM with media_urls for Instagram carousels. Default: auto-detected from media_url.

Post caption/description text.

Post title (used by YouTube and some other platforms).

Hashtags to append to caption. Include or omit the "#" prefix — both work. Example: ["ai", "contentcreator"] or ["#ai", "#contentcreator"].

ISO 8601 UTC datetime for scheduled posting (e.g. "2026-03-20T14:00:00Z"). Omit to post immediately. Must be in the future.

Social Neuron brand/project ID to associate this post with. Provide this when the account has multiple brands so brand voice and connected account routing stay scoped to the right brand.

Optional response format. Defaults to text.

If true, appends "Created with Social Neuron" to the caption. Default: false.

Connected account ID to post from. Optional when the resolved project has exactly one active account for the target platform — it is auto-bound. Required (with a clear error listing candidates) when multiple accounts exist for the same platform. Use list_connected_accounts to find the right ID. The account must be active and bound to the exact project_id.

Per-platform account IDs when posting to multiple platforms. Example: {"twitter": "abc123", "instagram": "def456"}. Use list_connected_accounts with the same project_id to find IDs.

Whether to persist non-R2 media_url/media_urls into R2 before posting. Default: true. Set to false only if you know the source URL will outlive the scheduling window and every target platform supports URL ingest.

Stable 8-128 character retry key (letters, numbers, underscore, hyphen). Reuse the same key when retrying the same publish request to prevent duplicate posts.

Post ID returned by list_recent_posts.

New future publish time as an ISO 8601 datetime with timezone.

Brand/project ID that owns the post. Defaults to the authenticated key's project or the account default.

Optional current schedule timestamp. If it changed since you read it, the update is rejected instead of silently overwriting it.

Brand/project ID to scope posts. Defaults to the authenticated key's project or the account default.

Filter to a specific platform.

Filter by post status.

Number of days to look back. Defaults to 7. Max 90.

Maximum number of posts to return. Defaults to 20.

Optional response format. Defaults to text.

Brand/project ID to scope connected accounts. Use the same project_id when calling schedule_post.

If true, include expired or inactive accounts as well as usable accounts.

Optional response format. Defaults to text.

Platform to connect. Lower-case: instagram, tiktok, youtube, etc.

Brand/project ID to bind the new social account to. Required when the account has multiple brands.

Response format. Default: text.

Platform to wait for.

Brand/project ID to scope the connection poll. Use the same project_id passed to start_platform_connection.

How long to wait, in seconds. Default 120.

Poll interval in seconds. Default 5.

Response format. Default: text.