Create & Publish

Create and publish a post in one request.

POST /v1/posts/publish

Create and publish in one request.

Auth: Bearer API key (required)

Request body

{
  "content": "Hello from the API!",
  "platforms": ["connected-account-uuid"],
  "media": ["media-uuid-optional"]
}

Headers

HeaderRequiredDescription
Idempotency-KeyRecommendedSafe retry

Response 202

{
  "post_id": "uuid",
  "tracking_id": "uuid",
  "status": "queued",
  "stream_url": "/v1/jobs/{tracking_id}/stream"
}

cURL

curl -X POST https://api.social0.app/v1/posts/publish \
  -H "Authorization: Bearer sk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "content": "Hello from the Social0 API!",
    "platforms": ["ACCOUNT_UUID"]
  }'