How to post on X/Twitter
via the API

Open Dashboard → AI & API and create a key. Copy it once. It starts with pw_live_. Send it on every request:

Authorization: Bearer pw_live_…

Every URL below starts at https://postwing.io/api/v1.

Connect the X account you want to post from. You only do this once. The platform value is x, including for Twitter.

The simple way is in the dashboard. Open Accounts, choose X, and finish the X login.

From the API, start that same login. The response includes a url. Open it and approve X.

curl -s -X POST "https://postwing.io/api/v1/accounts" \
  -H "Authorization: Bearer pw_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "platform": "x" }'

After you finish in the browser, sync. This imports the account into your workspace and returns the account id.

curl -s -X POST "https://postwing.io/api/v1/accounts/sync" \
  -H "Authorization: Bearer pw_live_…"

In the response, find the object where platform is x and copy account_id. That is the id you send when you create the post.

{
  "synced_count": 1,
  "accounts": [
    {
      "account_id": "e5f6a7b8-c9d0-1234-ef01-345678901234",
      "platform": "x",
      "handle": "brand",
      "display_name": "Brand",
      "status": "connected"
    }
  ]
}

Connected X in the dashboard instead? List accounts and copy the same field:

curl -s -X GET "https://postwing.io/api/v1/accounts" \
  -H "Authorization: Bearer pw_live_…"

A caption is enough on X. Send the text, a future time, and the X account_id you copied after sync. This call creates the post. X does not publish until you confirm in the next step. scheduled_at is UTC.

curl -s -X POST "https://postwing.io/api/v1/posts/preview" \
  -H "Authorization: Bearer pw_live_…" \
  -H "Content-Type: application/json" \
  -d '{
  "caption": "Faster publishing, now live.",
  "scheduled_at": "2026-10-12T15:00:00Z",
  "targets": [
    { "account_id": "e5f6a7b8-c9d0-1234-ef01-345678901234" }
  ]
}'

You get back three things that matter:

• preview: the caption, time, and X account. Check this before you confirm.
• confirmation_token: you send this in the next step
• expires_in_seconds: 300, so the token lasts 5 minutes

{
  "preview": {
    "caption": "Faster publishing, now live.",
    "scheduled_at": "2026-10-12T15:00:00.000Z",
    "post_type": "text",
    "targets": [
      {
        "account_id": "e5f6a7b8-c9d0-1234-ef01-345678901234",
        "platform": "x",
        "handle": "brand"
      }
    ]
  },
  "confirmation_token": "eyJ…signature",
  "expires_in_seconds": 300
}

A standard post is about 280 characters. Longer text can fail on accounts that do not support long posts.

The same text can go to LinkedIn and Facebook. Connect each channel the way you connected X, then copy its account_id from the sync response.

curl -s -X POST "https://postwing.io/api/v1/accounts" \
  -H "Authorization: Bearer pw_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "platform": "linkedin" }'

curl -s -X POST "https://postwing.io/api/v1/accounts" \
  -H "Authorization: Bearer pw_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "platform": "facebook" }'

Open each url, finish the login, then sync once. Copy account_id where platform is linkedin, and where platform is facebook.

Add those ids to targets on the create call. One request, one confirm. Every account publishes at the same scheduled_at. Leave caption off a target to use the shared caption. Set caption when that channel needs different text. X is the short one here.

curl -s -X POST "https://postwing.io/api/v1/posts/preview" \
  -H "Authorization: Bearer pw_live_…" \
  -H "Content-Type: application/json" \
  -d '{
  "caption": "We just shipped a faster way to publish updates.",
  "scheduled_at": "2026-10-12T15:00:00Z",
  "targets": [
    {
      "account_id": "e5f6a7b8-c9d0-1234-ef01-345678901234",
      "caption": "Faster publishing, now live."
    },
    { "account_id": "d4e5f6a7-b8c9-0123-def0-234567890123" },
    { "account_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890" }
  ]
}'

Threads accepts this text with no media. Instagram, TikTok, Pinterest, and YouTube need an image or a video. Pinterest also needs board_ids on its own target.

When the X preview looks right, confirm with the token from that response. Use the token as-is. Do not invent one.

curl -s -X POST "https://postwing.io/api/v1/posts/confirm" \
  -H "Authorization: Bearer pw_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "confirmation_token": "eyJ…signature" }'

The response includes view_url. Open it to see the post on your calendar. X publishes at the time you set. LinkedIn and Facebook publish then too, when you added them. You can edit or cancel later from the dashboard or with the same API.

If confirm says the token expired, create the post again and confirm the new token within 5 minutes.