Get Started
The PostHero API lets you create, schedule, and publish posts across 8 social media platforms programmatically.
How it works
1
Get your API key
Generate an API key from Settings > API in your dashboard.
2
List your accounts
Fetch your connected social media accounts to get their IDs.
3
Create a post
Send your content, choose platforms, and optionally schedule or publish immediately.
4
Publish
Posts publish automatically at the scheduled time, or you can trigger immediate publishing.
Prefer the terminal?
Use the official PostHero CLI to manage posts without writing any code.
npm install -g @posthero/cli posthero login posthero posts create
Base URL
Base URL
https://server.posthero.ai/api/v1Auth
Authorization: Bearer pk_...Quick Example
Create and publish a post in one request
curl --request POST \
--url https://server.posthero.ai/api/v1/posts \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"text": "Hello from the API!",
"platforms": [{ "platform": "linkedin", "accountId": "YOUR_ACCOUNT_ID" }],
"publishNow": true
}'