Network options
They go inside each target, keyed by the network’s name. All optional except TikTok’s.
{
"accountId": "acc_ig",
"instagram": { "format": "reel", "firstComment": "#autumn" }
}Images go to the feed and a single video is posted as a Reel. Several images make a carousel.
formatstringoptionalfeed,reelorstory. By default images go to the feed and a video is a Reel.shareToFeedbooleanoptionalReels only:
falsekeeps it out of the profile grid.collaboratorsstring[]optionalUp to 3 business or creator usernames invited as collaborators. Not for Stories.
firstCommentstringoptionalComment posted right after. Not for Stories.
coverUrlstring (uri)optionalReels only: cover image.
formatstringoptionalfeed,reelorstory.reelTitlestringoptionalReels only: a title separate from the text.
firstCommentstringoptionalComment posted right after. Not for Stories.
TikTok
TikTok requires the user to choose privacy and interactions, and to agree to post after seeing the preview (consent: true). Without these options the request is rejected.
privacystringrequiredWho sees it:
public,friends,followersorprivate.allowCommentsbooleanrequiredAllow comments.
allowDuetbooleanoptionalAllow duets.
allowStitchbooleanoptionalAllow stitches.
commercialContentstringoptionalown_brandwhen it promotes your business,paid_partnershipwhen sponsored. Not withprivateprivacy.autoAddMusicbooleanoptionalPhotos only: TikTok may add recommended music.
consenttruerequiredAlways
true: the user saw the preview and agreed to post.
YouTube
Vertical videos under 3 minutes are posted as Shorts. An account’s playlists are at GET /v1/accounts/{id}/youtube-playlists.
titlestringoptionalVideo title (up to 100 characters).
visibilitystringoptionalpublic,unlistedorprivate.madeForKidsbooleanoptionalCOPPA flag. YouTube may limit videos that do not set it.
categoryIdstringoptionalNumeric YouTube category id.
playlistIdstringoptionalAdd it to this playlist.
tagsstring[]optionalTags (500 characters in total).
firstCommentstringoptionalComment posted right after.
thumbnailUrlstring (uri)optionalCustom thumbnail.
containsSyntheticMediabooleanoptionalContains realistic AI-generated or altered content.
notifySubscribersbooleanoptionalfalseuploads it without notifying subscribers.
firstCommentstringoptionalComment posted right after.
disableLinkPreviewbooleanoptionalHide the link preview.
documentTitlestringoptionalTitle of document (PDF) posts.
X
The post’s text is the first tweet; thread adds the replies (280 characters each).
threadstring[]optionalThread replies, in order. The post’s text is the first tweet.
replySettingsstringoptionalWho can reply:
following,mentionedUsers,subscribersorverified.
Threads
Threads of up to 500 characters per post.
threadstring[]optionalThread replies, in order.
topicTagstringoptionalTopic of the post.
firstCommentstringoptionalComment posted right after.
Bluesky
Threads of up to 300 characters per post.
threadstring[]optionalThread replies, in order.
Without boardId the board picked when connecting is used. An account’s boards are at GET /v1/accounts/{id}/pinterest-boards.
titlestringoptionalPin title.
linkstring (uri)optionalWhere the Pin leads.
boardIdstringoptionalBoard. Defaults to the one picked when connecting.
Google Business
callToActionobjectoptionalThe post’s button.
callToAction
typestringrequiredlearn_more,book,order,shop,sign_uporcall.urlstring (uri)optionalWhere the button leads. Required except for
call.
Telegram
parseModestringoptionalText format:
htmlormarkdown.disableLinkPreviewbooleanoptionalHide the link preview.
silentbooleanoptionalSend without sound.
protectContentbooleanoptionalPrevent forwarding or saving it.
Snapchat
formatstringoptionalstory(gone after 24 h),saved_story(stays on the profile) orspotlight.
subredditstringoptionalSubreddit without
r/.titlestringoptionalPost title.
linkstring (uri)optionalMakes it a link post.
flairIdstringoptionalSubreddit flair.
nsfwbooleanoptionalMark it NSFW.
spoilerbooleanoptionalMark it as a spoiler.