Chirio
Get Started
Introduction
Quickstart
How Chirio works
Authentication
Platforms
Overview
Instagram
Threads
X
LinkedIn
Supa Hub
Guides
Connect accounts
Publish a post
Media requirements
Carousels
First comments
Idempotency and retries
Account lifecycle
Revocation and deletion
The dashboard
Billing
Plans
Metering
Quotas
Api Reference
Overview
Accounts
Posts
Errors
Changelog
Roadmap
TrademarkTrademark
Ctrl k
Search…
Sign up
Chirio
Get Started
Introduction
Quickstart
How Chirio works
Authentication
Platforms
Overview
Instagram
Threads
X
LinkedIn
Supa Hub
Guides
Connect accounts
Publish a post
Media requirements
Carousels
First comments
Idempotency and retries
Account lifecycle
Revocation and deletion
The dashboard
Billing
Plans
Metering
Quotas
Api Reference
Overview
Accounts
Posts
Errors
Changelog
Roadmap
TrademarkTrademark© Dopler. All rights reserved.
Built with Aveiro

LinkedIn

Personal profiles and company pages, multi-image posts, and the longest text limit of the four.
Updated 1mo ago
X
Supa Hub
Text limit3,000 characters
Mediaup to 10 images (2+ = multi-image post) **or** 1 video
Carouselmulti-image post, not a swipeable carousel
First commentyes, up to 1,250 characters
Video coveryes, as an uploaded image
Connection lastsaround 60 days
Units per write1

What the user needs

Any LinkedIn member can connect their personal profile. Company pages appear only for pages the connecting member administers. One connect can therefore create several accounts at once: the personal profile, plus one per page.
Page accounts are not in the redirect
The OAuth redirect returns only the personal profile's accountId. Call GET /api/v1/accounts afterwards to find the page accounts — their platformUserId reads organization:{id}. Each is targeted exactly like any other account.
{ "platform": "linkedin", "accountId": "the-page-account-id" }
If a member is made admin of a new page later, they need to reconnect before it appears.

Publishing behaviour

  • Text up to 3,000 characters — the most generous of the four.
  • One image publishes as a single-media post; 2–10 as a multi-image post.
  • One video, or images — never both in the same post.
LinkedIn treats several characters as formatting controls. Chirio escapes them for you, so brackets and punctuation in your copy come out as written. #hashtags pass through untouched.

Video covers

Set coverUrl on the video media item and Chirio uploads that image as the video's cover alongside the video itself. Without one, LinkedIn generates its own. The cover has to be declared before the upload begins — it is what makes LinkedIn issue an upload URL for it — so it cannot be added to a video that is already on its way. In practice that only means sending it in the same publish call, which is what you would do anyway.
thumbOffsetMs does not work here
LinkedIn has no way to name a frame of the video as its cover; it only accepts an uploaded image. Chirio refuses thumbOffsetMs on LinkedIn rather than accepting it and doing nothing, so you find out at the API rather than by looking at the published post.
If LinkedIn accepts the video but offers nowhere to put the cover, the publish fails rather than going out with LinkedIn's generated frame — the outcome supplying a cover was meant to avoid. Retry the call.

First comments

Supported, up to 1,250 characters, posted as the same author as the post.
A LinkedIn comment failure is not fixed by reconnecting
Unlike Instagram and Threads, a permission refusal here is an authorisation Chirio holds with LinkedIn, not something your user's connection can grant. Publishing keeps working normally. Contact support rather than sending your user through the connect flow again.

Connection lifetime

LinkedIn issues long-lived refresh credentials only to integrations it has specifically approved for it. In the common case a LinkedIn connection therefore needs re-authorising roughly every 60 days, rather than being refreshed indefinitely in the background.
Plan for it: check status on GET /api/v1/accounts and prompt the user before a campaign rather than after a failure. See Account lifecycle.

Common failures

Symptom
Cause
`invalid_post`, 3,000 charactersThe text is too long
`invalid_post`, one video or imagesYou mixed a video with images
`thumbOffsetMs` refusedLinkedIn takes a cover image, not a timestamp — send `coverUrl`
Comment fails on permissionsChirio-side authorisation — contact support, do not reconnect
Account `expired` after ~60 daysExpected on LinkedIn — reconnect
A company page is missingThe member does not administer it, or was granted admin after connecting