​

LinkedIn

​

API overview

​

Use cases

• Publish as a personal professional profile.
• Publish company updates from an approved organization page.
• Use page-specific scopes only when the user connects a page account.

​

When to use

• When the post should appear as a member profile update.
• When the post should appear as an organization page update.

​

When not to use

• When you need a video-first workflow.
• When the page has not been approved for organization access.

​

Examples

​

Profile post

{
  "platforms": [
    {
      "platform": "linkedin",
      "accountId": "li_profile_123",
      "content": "Sharing a new engineering write-up.",
      "mediaItems": [
        {
          "type": "image",
          "url": "https://cdn.postova.dev/article-card.png"
        }
      ]
    }
  ]
}

​

Page post

{
  "platforms": [
    {
      "platform": "linkedin",
      "accountId": "li_page_456",
      "content": "Product launch update from the team page."
    }
  ]
}

​

How to post

1. Choose whether you are connecting a profile or a page.
2. For pages, ensure the LinkedIn account has approved organization access.
3. Create text or image content and publish through the selected account.

​

Authentication

​

Account types

• Profile: Publishes as a member profile. Scopes: openid, profile, email, w_member_social
• Page: Publishes as an approved organization page. Scopes: openid, profile, email, w_member_social, r_organization_social, w_organization_social

​

Default scopes

​

Supported media

• text
• image
• Supports text and image publishing.

​

Settings

​

Common errors

• No organization access: The account was connected as a page, but the user does not have approved organization permissions. Fix: Approve organization access in LinkedIn before connecting the page.

​

Constraints

• Organization pages require approved organization access.
• There are no provider-specific publishing settings today.

​

Notes

• Page connections request organization read/write scopes.