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.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
A direct command skips the review prompt. Inspect the source before running it.
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.
