LinkedIn — Postli docs

Home / Docs / LinkedIn

Provider

Publish to your personal LinkedIn profile or to any LinkedIn Company Page you administer. Postli supports text, image, video, and document (PDF carousel) posts.

Requirements

A LinkedIn account for personal posts.
For Company Page posts: Super Admin or Content Admin role on the Page.
The LinkedIn account must accept Postli’s Sign In with LinkedIn consent.

Spec

Account types

Personal profile, Company Page

Auth

LinkedIn OAuth 2.0 (Authorisation Code flow)

Token type

60-day access token (no refresh token in the standard product) — reconnect required at expiry

Post types

Text, image (single / multi), video, document (PDF), article share

Character limit

Up to 3,000 characters

Image

JPEG, PNG · ≤5 MB · up to 9 in a multi-image post

Video

MP4 · ≤5 GB · 3 s – 10 min · 256×144 to 4096×2304

Document

PDF · ≤100 MB · ≤300 pages

Auto-comments

Supported via reply on owned posts (Instant, Time)

Create your LinkedIn app

LinkedIn requires app-level approval for each product (e.g. Marketing Developer Platform) before the relevant scopes can be granted. Plan for a 2–5 day review per product.

Go to linkedin.com/developers/apps and click Create app. Associate the app with a LinkedIn Company Page you administer — LinkedIn won’t let you create an app without one.
Open the Products tab and request:
- Sign In with LinkedIn using OpenID Connect — for the personal-profile flow.
- Share on LinkedIn — for w_member_social.
- Community Management API — for Company Page publishing (w_organization_social, r_organization_social).
- Advertising API (optional but recommended) — without it, LinkedIn does not issue refresh tokens, so merchants must re-auth every 60 days.
On the Auth tab, add the OAuth 2.0 Authorised Redirect URL:
https://app.usepostli.com/api/integration/linkedin/callback
Copy the Client ID and Primary Client Secret from the same Auth tab.
In Postli, open Settings → Integrations → LinkedIn, paste both values, and save.

Refresh tokens are gated. Without the Advertising API product approved, LinkedIn returns a 60-day access token with no refresh token. Postli will fire an account-health alert before expiry, but the merchant has to reconnect manually. Request the Advertising API early to avoid this.

OAuth setup

Once credentials are saved, go to Integrations → LinkedIn → Connect, then choose Profile or Company Page. The OAuth scopes requested differ by destination type.

Scopes for personal profile:

openid # OIDC identity profile # name & avatar email # account email w_member_social # post on behalf of the member

Additional scopes for Company Page posting:

w_organization_social # publish on a Page r_organization_social # read engagement on Page posts rw_organization_admin # list Pages the user administers

Post types in detail

Text post

Up to 3,000 characters. URLs auto-unfurl into a card if the destination supports OG tags. Hashtags and @mentions render as native LinkedIn entities.

Image post

One to nine images. Multi-image is rendered as a carousel in feed. The Postli channel tab lets you reorder via drag.

Video post

Single video uploaded with caption. LinkedIn transcodes for adaptive playback — expect the video to take 1–3 minutes to be playable after upload.

Document post

PDF rendered in feed as swipeable pages — LinkedIn’s answer to the carousel. Up to 300 pages, but engagement drops sharply past page 10.

Auto-comments

Implemented as comment-on-own-post. Instant and Time conditions both work. LikeCount uses the Page-insights endpoint and is supported on Company-Page posts.

Rate limits

LinkedIn enforces application-wide and per-member throttles documented at the API level. For typical merchant volume (<30 posts / day across personal and Pages), throttling is not a concern.

Gotchas & best practices

No refresh token. Standard LinkedIn OAuth (without Marketing Developer Platform approval) does not issue refresh tokens. Postli surfaces a re-auth banner around day 55.
Page admin role required. Even if you can post manually from LinkedIn’s UI as a Page editor, the API requires Super Admin or Content Admin to issue tokens that publish to the Page.
Multi-image limit is 9, not 10 like Instagram.
Document posts cannot be edited after publishing — if you spot a typo on page 3, re-upload.
URL preview requires the destination to serve OG tags. If your storefront is missing them, the post will publish without a card.

Webhooks

Postli does not subscribe to LinkedIn webhooks (these are reserved for Marketing Developer Platform partners). Engagement is polled.