PostWing Agent API

Base URLs

• API: https://postwing.io/api/v1
• OpenAPI: https://postwing.io/api/v1/openapi.json
• Discovery: GET https://postwing.io/api/v1
• Muse guide: postwing.io/muse

Authentication

Send a Bearer token on every request. Prefer OAuth for third-party agents. API keys work for simple connectors and scripts.

Write safety (required)

Scheduling and edits never run in one shot. Agents must preview first, show the user the draft, then confirm with the returned token.

1. POST /posts/preview with caption, time, and targets
2. Show the preview. Wait for the user to approve.
3. POST /posts/confirm with confirmation_token (expires in 5 minutes)

• Always call preview before confirm. Never invent a confirmation token.
• Show the preview to the user and wait for explicit approval before confirm.
• Confirmation tokens expire in 5 minutes and are bound to that user.
• Cancel or disconnect only after the user agrees (confirm: true).
• Only operate on accounts and posts returned by the API for the authenticated user.
• Use the user’s PostWing timezone for relative times like “tomorrow at 9am”.

Example: X quote post

curl -s -X POST https://postwing.io/api/v1/posts/preview \
  -H "Authorization: Bearer pw_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "caption": "Adding my take",
    "scheduled_at": "2026-09-21T15:00:00Z",
    "targets": [{
      "account_id": "YOUR_X_ACCOUNT_UUID",
      "platform_options": {
        "quote_tweet_url": "https://x.com/someone/status/1234567890"
      }
    }]
  }'

Example: schedule a post

# 1) Preview
curl -s -X POST https://postwing.io/api/v1/posts/preview \
  -H "Authorization: Bearer pw_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "caption": "Hello from Muse",
    "scheduled_at": "2026-09-21T09:00:00Z",
    "platforms": ["instagram", "linkedin"]
  }'

# 2) After the user approves, confirm with the token from preview
curl -s -X POST https://postwing.io/api/v1/posts/confirm \
  -H "Authorization: Bearer pw_live_…" \
  -H "Content-Type: application/json" \
  -d '{"confirmation_token": "…"}'

Confirmed posts appear on the user’s PostWing calendar in the active workspace, same as the dashboard.

Access requirements

• Active PostWing subscription (7-day free trial available)
• Connected social accounts in the user’s workspace (or connect via the API)
• API key or OAuth token with the scopes you need
• Platforms: Instagram, TikTok, YouTube, LinkedIn, X, Facebook, Pinterest, Threads