PostHero API

v1 Reference

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.
PlatformFields
linkedin
textvia top-level text field, 3,000 chars
twitter
text280 chars (\n\n to split threads)
threads
text500 chars (\n\n to split threads)
bluesky
text300 chars (\n\n to split threads)
instagram
text2,200 chars
contentTypefeed / reel / story / carousel
facebook
text63,206 chars
youtube
textdescription, 5,000 chars
titlerequired, 100 chars
tagsarray
privacypublic / unlisted / private
videoTypelong / short
tiktok
textcaption, 2,200 chars
privacyLevelPUBLIC_TO_EVERYONE / MUTUAL_FOLLOW_FRIENDS / FOLLOWER_OF_CREATOR / SELF_ONLY
allowCommentsboolean
allowDuetboolean, video only
allowStitchboolean, video only
postModedirect / draft
autoAddMusicboolean, 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
}'