PostHero API

v1 Reference

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.

Base URL

Base URL
https://server.posthero.ai/api/v1
AuthAuthorization: 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
}'

Explore the API