Send them in options, keyed by network, on POST /api/post and POST /api/schedule (or inside a per_platform draft). A network ignores the options of the others.
A thread on X, Bluesky and Mastodon: per_platform.<network>.thread is the list of posts after the text, each published as a reply to the one before (Bluesky reply refs, Mastodon in_reply_to_id). Or thread: true: PostWire splits a long text at the network's limit (X 280 as X counts, Bluesky 300, Mastodon 500 or the server's own), at paragraph, sentence or word boundaries, never inside a link. Media stays on the first post. Bluesky and Mastodon take up to 10 posts, X up to 26. A post over the limit is refused before anything goes out, never cut. A thread counts as one post of the plan.
First comment on LinkedIn, X, Bluesky and Mastodon: first_comment (in per_platform.<network> or options.<network>) is posted by the author right under the post, or under the last post of a thread. It is the place for the link: the post keeps its reach and the link is one tap away. On X it is the reply under the chain and uses X credits like any X post.
Every post's URL comes back in the result (thread.posts on Bluesky and Mastodon, thread.tweets on X). If the network refuses a later post, the posts before it stay published and the result names the one refused and lists the rest (thread.not_posted). A first comment that fails is tried again on its own later; the post is never sent twice.
A thread and a first comment
JSON
{
"platforms": [
"bluesky",
"mastodon",
"linkedin"
],
"text": "We rebuilt our onboarding from scratch. Here is what changed.",
"per_platform": {
"bluesky": {
"thread": [
"Step 1: one screen instead of four.",
"Step 2: connect a network before you write anything."
],
"first_comment": "The full write-up: https://example.com/onboarding"
},
"mastodon": {
"thread": true,
"first_comment": "The full write-up: https://example.com/onboarding"
},
"linkedin": {
"first_comment": "The full write-up: https://example.com/onboarding"
}
}
}
Who sees the post. Words also work: public, followers, friends, private. When TikTok does not allow the value for this creator, the closest allowed level that is not more open is used and the result says so. Default: the level saved for the connection (PATCH /api/connect/tiktok/settings with default_privacy public, followers, friends or private; null clears it), else SELF_ONLY. One of: PUBLIC_TO_EVERYONE, FOLLOWER_OF_CREATOR, MUTUAL_FOLLOW_FRIENDS, SELF_ONLY.
options.tiktok.disable_comment
boolean
Default false.
options.tiktok.disable_duet
boolean
Videos only. Default false.
options.tiktok.disable_stitch
boolean
Videos only. Default false.
options.tiktok.brand_organic_toggle
boolean
Discloses that the post promotes the creator's own business. Default false.
options.tiktok.branded_content_toggle
boolean
Discloses a paid partnership with a third party. Cannot be private. Default false.
Send the photos or the video to the creator's TikTok inbox as a draft instead of publishing: the person opens TikTok, adds a trending sound and posts it from there. The result says delivered_to: "inbox" and as_draft: true. Needs a connection made with the video.upload permission. Default false.
options.tiktok.upload_method
string
Videos only: the "upload method" editors use so TikTok leaves the export as it is. PostWire rewrites the MP4 header on the way to TikTok (nothing is re-encoded, no daily limit, files up to 1 GB streamed). max is the usual choice (what editors mean by the method); safe rewrites the movie header only. Also accepted at the top level of /api/post and /api/schedule as upload_method. When the file cannot be patched (a host without byte ranges, a fragmented MP4) the post goes out as-is and the result's notice says so. One of: max, safe.
Posted as the author's first comment right after the post (where a link goes without hurting reach). A failed comment is retried later; the post is never re-sent. Also accepted as per_platform.linkedin.first_comment.
options.linkedin.document_url
string (uri)
A PDF, PPT or DOC published as a document (carousel) post.
Alt text for photo_url (with media, each item has its own alt).
options.bluesky.first_comment
string
One reply by the author under the post (under the last post of a thread): the place for the link. At most 300 characters. Also accepted as per_platform.bluesky.first_comment.
options.bluesky.thread
array of string or true
Same as per_platform.bluesky.thread: the posts after the main one, or true to split a long text at 300 characters.
Alt text for photo_url or video_url (with media, each item has its own alt).
options.mastodon.first_comment
string
One reply by the author under the post (under the last post of a thread): the place for the link. At most 500 characters, or the server's own limit. Also accepted as per_platform.mastodon.first_comment.
options.mastodon.thread
array of string or true
Same as per_platform.mastodon.thread: the posts after the main one, or true to split a long text at the server's limit.
One more X post published as a reply under the last post of the chain: under the main post, or under the last post of per_platform.x.thread when there is one (the usual place for a link). At most 280 characters as X counts them (a link counts 23, an emoji 2); longer is refused with code bad_x_thread before anything goes out. It is an X post: 1 X credit, 10 with a link, and it counts toward the daily X limit. Also accepted as per_platform.x.reply.
options.x.first_comment
string
Same as reply, by the name the other networks use. reply wins when both are sent.
Article title. Without one, an opening '# heading' of the text, else its first line (the result says so). The writer keeps it to 70 characters.
options.wordpress.tags
array of string
Tag names (up to 10). Existing tags are matched by name; new ones are created when the user may (Editors, Administrators), else listed in the result's notice.
options.wordpress.summary
string
The post's excerpt.
options.wordpress.status
string
publish (default) or draft: saved on the blog for review there. Default: the connection's choice (default_status). Also per_platform.<blog>.status. One of: publish, draft.
options.wordpress.categories
array of string
Category names (up to 10), matched or created the same way.
options.wordpress.featured_image
string (uri)
Image uploaded to the media library and set as the featured image (default: photo_url). Up to 15 MB.
Article title. Without one, an opening '# heading' of the text, else its first line (the result says so). The writer keeps it to 70 characters.
options.devto.tags
array of string
At most 4; sent as lowercase letters and digits ("Web Dev" becomes webdev). Up to 4 items.
options.devto.summary
string
The article's description.
options.devto.status
string
publish (default) or draft: saved on the blog for review there. Default: the connection's choice (default_status). Also per_platform.<blog>.status. One of: publish, draft.
Article title. Without one, an opening '# heading' of the text, else its first line (the result says so). The writer keeps it to 70 characters.
options.hashnode.tags
array of string
Tag names, up to 5. Up to 5 items.
options.hashnode.summary
string
The SEO description.
options.hashnode.status
string
publish (default) or draft: saved on the blog for review there. Default: the connection's choice (default_status). Also per_platform.<blog>.status. One of: publish, draft.
options.hashnode.subtitle
string
Up to 150 characters.
options.hashnode.canonical_url
string (uri)
Where the article was first published (originalArticleURL).
true: publish as a long-form article (NIP-23, kind 30023) with title, summary, image and tags; false: always a note (kind 1). Default: a note, or an article past 2,000 characters.
options.nostr.title
string
Long-form only. Default: the first line.
options.nostr.summary
string
Long-form only.
options.nostr.tags
array of string
Topics (t tags), with the post's own #hashtags; up to 10.
Before you choose a TikTok privacy level, GET /api/tiktok/creator-info returns the levels TikTok allows for the connected creator.