Platform-Specific Content
Use the
platformContent object to customize content and settings per platform. This is a top-level field in the Create Post and Update Post request body.
How it works:
- The top-level text field is used as the default text for all platforms (and as the LinkedIn text).
- To override text for a specific platform, set platformContent.<platform>.text.
- Some platforms accept additional settings (privacy, content type, etc.) inside platformContent.<platform>.
- If you don't include a platform in platformContent, it uses the default text.
Media is always top-level — images, videos, and PDFs are passed via the media object, not inside platformContent. All platforms in the post share the same media. See Publishing with Media.
Threads — for Twitter, Threads, and Bluesky threads, separate each post with double line breaks (\n\n) in the text and set isThread: true.| Platform | Fields |
|---|---|
text — via top-level text field, 3,000 chars | |
text — 280 chars (\n\n to split threads) | |
| threads | text — 500 chars (\n\n to split threads) |
| bluesky | text — 300 chars (\n\n to split threads) |
text — 2,200 chars contentType — feed / reel / story / carousel | |
text — 63,206 chars | |
| youtube | text — description, 5,000 chars title — required, 100 chars tags — array privacy — public / unlisted / private videoType — long / short |
| tiktok | text — caption, 2,200 chars privacyLevel — PUBLIC_TO_EVERYONE / MUTUAL_FOLLOW_FRIENDS / FOLLOWER_OF_CREATOR / SELF_ONLY allowComments — boolean allowDuet — boolean, video only allowStitch — boolean, video only postMode — direct / draft autoAddMusic — boolean, carousels only, default true |
Example request
// Post to LinkedIn + Twitter with different text
curl --request POST \
--url https://server.posthero.ai/api/v1/posts \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"text": "Excited to announce our new feature! Here is a deep dive into how we built it and what it means for the industry...",
"platforms": [
{ "platform": "linkedin", "accountId": "acc_li_1" },
{ "platform": "twitter", "accountId": "acc_tw_1" }
],
"platformContent": {
"twitter": {
"text": "We just launched something big. Check it out!"
}
},
"media": { "images": ["https://s3.amazonaws.com/..."] },
"publishNow": true
}'