Schedule and publish social media posts across LinkedIn, Twitter/X, Instagram, Facebook, YouTube, TikTok, Threads, and Bluesky using the PostHero API. Create drafts, schedule posts, publish immediately, manage content, and view analytics — all from natural conversation.
Schedule and publish social media posts across LinkedIn, Twitter/X, Instagram, Facebook, YouTube, TikTok, Threads, and Bluesky using the PostHero API. Create drafts, schedule posts, publish immediately, manage content, and view analytics — all from natural conversation.
Informational only. Threading is auto-detected per platform from \n\n\n (triple newline) separators in each platform's text — you don't need to set this.
platformContent
object
No
Per-platform text overrides (see below)
media
object
No
Media attachments (see below)
isAutoPlug
boolean
No
LinkedIn-only. Schedule a chain of comments on the user's own LinkedIn post after publish (see Auto-plug below)
autoPlug
array
No
Comments to schedule when isAutoPlug is true. Each entry: { comment, delay, image? }
The top-level text field is the canonical default for every platform. Set platformContent.<platform>.text only when you need a different copy for that specific platform — providing the override automatically marks that platform as unsynced and leaves all other platforms reading the top-level text. This includes LinkedIn: send platformContent.linkedin.text for a LinkedIn-specific version, and the top-level text stays untouched for the rest.
{"platformContent":{"twitter":{"text":"Short tweet version"},"linkedin":{"text":"Longer LinkedIn version with #hashtags"},"bluesky":{"text":"Bluesky-specific text"},"threads":{"text":"Threads version"},"facebook":{"text":"Facebook version"},"instagram":{"text":"Instagram caption","contentType":"feed"},"youtube":{"text":"Video description","title":"My Video Title","tags":["tag1","tag2"],"privacy":"public","videoType":"long"},"tiktok":{"text":"TikTok caption","privacyLevel":"PUBLIC_TO_EVERYONE","allowComments":true,"allowDuet":true,"allowStitch":true}}}
Use URLs returned by the media upload endpoint. Up to 4 images, or 1 video, or 1 carousel PDF.
Threads: Threading is auto-detected per platform from \n\n\n (triple newline) separators in each platform's text. No isThread flag needed.
Works for Twitter (280 chars/tweet), Bluesky (300 chars/post), and Threads (500 chars/post).
Each platform threads independently. To thread on X but post a single long-form on LinkedIn, put \n\n\n only in platformContent.twitter.text and leave LinkedIn's text without separators.
Example — thread on X, single long-form on LinkedIn, from one post:
{"platforms":[{"platform":"linkedin","accountId":"abc123"},{"platform":"twitter","accountId":"def456"}],"platformContent":{"linkedin":{"text":"Long LinkedIn post. Multiple paragraphs fine — no triple newlines, so this stays as a single post."},"twitter":{"text":"Tweet 1 — hook.\n\n\nTweet 2 — context.\n\n\nTweet 3 — CTA."}}}
Auto-plug (LinkedIn comments): schedule follow-up comments on the user's own LinkedIn post after it publishes. Useful for "drop the link in the first comment" patterns, follow-up CTAs, or thread-style replies. LinkedIn only — other platforms ignore these fields.
Set isAutoPlug: true.
Provide autoPlug as an array of { comment, delay, image? } entries.
delay is in milliseconds. The first entry fires that long after the post publishes; each subsequent entry fires that long after the previous comment.
image is optional — pass any HTTPS URL (or one returned by /media/upload).
After each comment posts, the entry gets a commentIdOnPlatform field on subsequent GETs.
Example — publish a LinkedIn post with two follow-up comments:
{"text":"Just shipped our new API! Excited to see what people build with it.","platforms":[{"platform":"linkedin","accountId":"abc123"}],"isAutoPlug":true,"autoPlug":[{"comment":"Docs are here: https://posthero.ai/docs/api","delay":60000},{"comment":"Reply or DM if you hit anything weird — happy to help.","delay":180000}],"publishNow":true}
Response:
{"success":true,"data":{"id":"post_abc123","status":"scheduled","text":"My post content here...","platforms":[{"platform":"linkedin","accountId":"abc123"}],"schedule":"2026-04-15T09:00:00Z","createdAt":"2026-04-10T10:00:00Z"}}
{"success":true,"data":{"posts":[{"id":"post_abc123","text":"My post content...","status":"published","platforms":[{"platform":"linkedin","accountId":"abc123","status":"published","postId":"urn:li:share:123456","postUrl":"https://linkedin.com/feed/update/..."}],"schedule":null,"publishedAt":"2026-03-15T14:00:00Z","createdAt":"2026-03-10T10:00:00Z"}],"pagination":{"page":1,"limit":20,"total":45,"hasMore":true}}}
GET /posts/:id
Get full details of a single post including per-platform publishing status, post IDs, and URLs.
