Docs
LinkedIn

Overview

Connect LinkedIn personal profiles, scopes, capabilities, and known limits.

Onepostly maps the LinkedIn Posts API (member / Share on LinkedIn) into the same /v1/* surface as other platforms. This section covers LinkedIn-only behavior.

Company Pages are not supported in this release — only the authenticated member’s personal profile.

In this section

PageTopics
PostsPublish text, image, multi-image, video; schedule; remote delete

Cross-platform API flow: Media, Webhooks.

Connect

  1. Dashboard → Connections → connect LinkedIn
  2. Approve scopes in the LinkedIn consent screen
  3. Resolve connectionId with your API key:
curl https://api.onepostly.com/v1/connections \
  -H "x-api-key: op_YOUR_KEY"

Use the matching row’s id (where platform is "linkedin") as connectionId in publish requests.

OAuth scopes

ScopeUsed for
openid / profilePerson URN + display name (Sign In with LinkedIn using OpenID Connect)
w_member_socialPublish posts, upload images/videos, delete (Share on LinkedIn)

OAuth 2.0 authorization code. Access tokens last about 60 days; reconnect before expiry if LinkedIn does not issue a refresh token for your app.

Auth errors

CodeMeaning
TOKEN_INVALID / 401Expired or invalid token → reconnect
PERMISSION_DENIED / 403Missing scope → reconnect with Share on LinkedIn + OpenID Connect

Capabilities

ActionSupportedNotes
Create postYesPOST /v1/posts
Text-onlyYes
ImageYes
Multi-imageYes2–20 images
VideoYes
Stories / thread / quoteNo
ScheduleYesscheduledFor + timezone
Remote deleteYesDELETE …/destinations/:id
InsightsNo
CommentsNo
Like / unlikeNo
Bookmark / retweetNo

Known limitations

  • Personal profile only — no organization / Company Page posting yet
  • Comments, reactions, and insights are not supported (requires LinkedIn Community Management API access)
  • Video must be MP4-compatible, roughly 75 KB–500 MB, 3s–30m

See also