API & developer docs — Post Bridge

Authentication

Every request carries your API key as a bearer token. Create keys in Settings → API Keys.

Authorization: Bearer pb_live_xxxxxxxxxxxx

Connecting accounts

Accounts are connected in the app via OAuth (per platform, multiple accounts each). In this reference build, connections are demo-mode and managed from the Connections screen. The API references them by platform + handle.

Create a post

POST/v1/posts

Compose and schedule (or immediately publish) a post across platforms. Per-platform overrides supported.

curl -X POST https://api.post-bridge.app/v1/posts \
  -H "Authorization: Bearer pb_live_••••" \
  -H "Content-Type: application/json" \
  -d '{
    "caption": "Shipped a new feature today 🚀",
    "platforms": ["twitter","linkedin","bluesky"],
    "overrides": { "linkedin": "The longer, professional version…" },
    "media_url": "https://cdn.example.com/clip.mp4",
    "schedule_at": "2026-07-25T15:00:00Z"
  }'

List posts

GET/v1/posts?status=scheduled

Fetch your posts by status: scheduled, posted, or draft.

curl https://api.post-bridge.app/v1/posts?status=scheduled \
  -H "Authorization: Bearer pb_live_••••"

Checkout — runnable

Post Bridge commerce runs through the platform's free-mode gateway. The button below fires a real request from your browser and shows the raw response.

POST/site-api/checkout

Records a free-mode order object and returns a confirmation. No card is charged.

POST /site-api/checkout
Authorization: Bearer 
{ "items": [{ "name": "API test order", "price": 0, "quantity": 1 }] }

// response appears here

Visitor identity — runnable

POST/site-api/visitor

Mint or return this browser's anonymous identity (used to persist your posts & drafts).

POST /site-api/visitor

// response appears here

SDKs & webhooks

Official Node and Python SDKs wrap the REST API. Webhooks fire on post.published and post.failed so you can react in your own systems. Ask us for early access.