Can I add images or a video?

Yes. Put images in media_items, up to 20. A video is one file with type video. There are no LinkedIn platform_options to set.

Do I call the LinkedIn API myself?

You call PostWing. PostWing publishes to LinkedIn for you. You create the post, then confirm it.

What if I have more than one LinkedIn account?

Sync, or GET /accounts, returns every LinkedIn profile and page. Copy the account_id for the one you want and pass that id in targets.

Where does the post show up after I confirm?

On your PostWing calendar right away, in the same workspace as posts you create in the dashboard. LinkedIn publishes it at scheduled_at. The confirm response includes view_url.

Can one request post to LinkedIn, X, and Facebook?

Yes. A text post can include all three account ids in targets. Confirm once. They publish together at scheduled_at. Add media_items if you also want Instagram or TikTok.

Is the API included in the plan?

Yes. API access works with an active PostWing subscription, including the 7-day free trial. Plans start at $9.99/mo. There is no separate API quota beyond rate limits.

LinkedIn API

How to post on LinkedIn
using the API

Post and schedule on LinkedIn programmatically using the API. Create a key, connect LinkedIn, and write the post.

the whole flow

Five steps, then it is scheduled

You call PostWing. PostWing publishes to LinkedIn at the time you set. The post also shows up on your calendar.

01Create an API key
02Connect LinkedIn
03Create the post
04Cross-post to more channels
05Confirm it

Create an API key

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

Header

Authorization: Bearer pw_live_…

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

Connect LinkedIn

Connect the LinkedIn profile or page you want to post from. You only do this once.

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

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

Start connect

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

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

Sync

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 linkedin and copy account_id. That is the id you send when you create the post.

Sync response

{
  "synced_count": 1,
  "accounts": [
    {
      "account_id": "d4e5f6a7-b8c9-0123-def0-234567890123",
      "platform": "linkedin",
      "handle": "company",
      "display_name": "Brand",
      "status": "connected"
    }
  ]
}

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

List accounts

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

Create the post

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

Create a text post

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": "d4e5f6a7-b8c9-0123-def0-234567890123" }
  ]
}'

You get back three things that matter:

preview: the caption, time, and LinkedIn 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

Response

{
  "preview": {
    "caption": "We just shipped a faster way to publish updates.",
    "scheduled_at": "2026-10-12T15:00:00.000Z",
    "post_type": "text",
    "targets": [
      {
        "account_id": "d4e5f6a7-b8c9-0123-def0-234567890123",
        "platform": "linkedin",
        "handle": "company"
      }
    ]
  },
  "confirmation_token": "eyJ…signature",
  "expires_in_seconds": 300
}

Cross-post to all 8 platforms

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

Connect X

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

Connect Facebook

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 x, 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 shorter text.

Create one text post for three channels

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": "d4e5f6a7-b8c9-0123-def0-234567890123" },
    {
      "account_id": "e5f6a7b8-c9d0-1234-ef01-345678901234",
      "caption": "Faster publishing, now live."
    },
    { "account_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890" }
  ]
}'

X and Facebook accept this text with no media. Instagram and TikTok need an image or a video, so add media_items before you include those accounts.

Confirm the post

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

Confirm

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. LinkedIn publishes at the time you set. X 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.

media

Add an image or a video

Media is optional. Use the same LinkedIn account_id. An image goes out with the caption. A video is one file.

Create an image post

curl -s -X POST "https://postwing.io/api/v1/posts/preview" \
  -H "Authorization: Bearer pw_live_…" \
  -H "Content-Type: application/json" \
  -d '{
  "caption": "A look at the new office",
  "scheduled_at": "2026-10-12T18:00:00Z",
  "targets": [
    { "account_id": "d4e5f6a7-b8c9-0123-def0-234567890123" }
  ],
  "media_items": [
    { "url": "https://cdn.example.com/office.jpg", "type": "image" }
  ]
}'

Add more image objects in media_items for a carousel, up to 20. For a video, send one item with type video instead. LinkedIn has no extra platform_options.

The image or video URL has to be public HTTPS. Videos imported from a URL need to be 100MB or smaller. A file on your computer uses the direct upload URL, covered in the API docs.

Details worth knowing

scheduled_at has to be a future time in ISO 8601, usually UTC.
Creating the post does not publish it. Confirm is the step that schedules it.
LinkedIn accepts a caption alone. Images and video are optional.
The confirmation token expires in 5 minutes and only works for the user who created the post.
API access is included on every plan, from $9.99/mo. Posts count as normal posts on your account.

API docs LinkedIn posting API Pricing

questions

LinkedIn API FAQ

Yes. Create the post with caption, scheduled_at, and the LinkedIn account_id. Leave out media_items. Then confirm with the token.

ready when you are

Schedule your next LinkedIn post from the API

Create a key, connect LinkedIn, and create the post.

How to post on LinkedInusing the API