Publish

POST /api/v1/publish is the immediate-publish endpoint. It dispatches a payload to every platform in the platforms array in parallel, using the credentials the user has connected in their Post-EZ account. It is the same code path the in-app composer uses, so anything that ships from the UI will ship from this endpoint too.

Required scope: publish. Rate limit: 60 requests per minute per key.

Request

curl -X POST https://postez.app/api/v1/publish \
  -H "Authorization: Bearer pz_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "platforms": ["instagram", "x", "linkedin"],
    "content": "Shipping the public API today. /docs is live.",
    "title": "Public API",
    "media_urls": ["https://cdn.example.com/launch.png"]
  }'

Body fields

• platforms (string[], required) — one or more of instagram, tiktok, youtube, x, linkedin, facebook, threads, pinterest, , , , , , , , , , . Unknown values are silently dropped.