Quick Start

Get up and running with the PublishQ API in under 5 minutes.

Create an API key

Go to Settings → API Keys in the PublishQ dashboard and create a key with the scopes you need.

Authenticate

Pass the key as a Bearer token in every request:

curl https://publishq.com/api/v1/accounts \
  -H "Authorization: Bearer pq_live_..."

List your connected accounts

curl https://publishq.com/api/v1/accounts \
  -H "Authorization: Bearer pq_live_..."

Create a post

curl -X POST https://publishq.com/api/v1/posts \
  -H "Authorization: Bearer pq_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Hello from the API!",
    "accounts": [
      { "accountId": "acc_..." }
    ],
    "scheduledAt": "2026-04-07T12:00:00Z"
  }'

Key concepts

A Post is a single object with an accounts[] array. Each entry represents the post on one connected social account.
Media is uploaded separately via POST /media and referenced by ID when creating posts.
Workspaces organize your connected accounts into groups.

Changelog

What's new and what changed in the PublishQ API.

On this page

Create an API key

List your connected accounts