LinkedIn

Overview

Publish text posts, images, videos, and articles to LinkedIn personal profiles and company pages. PostPeer handles OAuth, token management, and LinkedIn's media upload process.

Quick Start

1. Connect a LinkedIn Account

curl https://api.postpeer.dev/v1/connect/linkedin \
  -H "x-access-key: YOUR_API_KEY"

Response:

{
	"url": "https://www.linkedin.com/oauth/v2/authorization?..."
}

Redirect the user to the url. After authorization, the account is connected to your project. See Connect Accounts for the full OAuth flow.

2. Get the Account ID

curl https://api.postpeer.dev/v1/connect/integrations \
  -H "x-access-key: YOUR_API_KEY"

Find the integration with "platform": "linkedin" and note the id.

3. Publish a Post

curl -X POST "https://api.postpeer.dev/v1/posts" \
  -H "x-access-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Excited to share our latest update!",
    "platforms": [
      { "platform": "linkedin", "accountId": "li_123" }
    ],
    "publishNow": true
  }'

import PostPeer from '@postpeer/node';

const client = new PostPeer();
const { data } = await client.posts.create({
	body: {
		content: 'Excited to share our latest update!',
		platforms: [{ platform: 'linkedin', accountId: 'li_123' }],
		publishNow: true,
	},
});

from postpeer import PostPeer

with PostPeer() as client:
    post = client.posts.create(
        content="Excited to share our latest update!",
        platforms=[{"platform": "linkedin", "accountId": "li_123"}],
        publish_now=True,
    )

Response:

{
	"success": true,
	"status": "published",
	"postId": "post_abc123",
	"platforms": [
		{
			"platform": "linkedin",
			"success": true,
			"platformPostUrl": "https://www.linkedin.com/feed/update/urn:li:share:123456"
		}
	]
}

Features

Text Posts

Post text updates up to 3,000 characters.

Images & Videos

Attach media using the mediaItems array:

curl -X POST "https://api.postpeer.dev/v1/posts" \
  -H "x-access-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Here'\''s a look at what we'\''ve been building.",
    "platforms": [
      { "platform": "linkedin", "accountId": "li_123" }
    ],
    "mediaItems": [
      { "type": "image", "url": "https://cdn.example.com/photo.jpg" }
    ],
    "publishNow": true
  }'

Supported media:

Images: JPG, PNG, GIF (up to 9 per post)
Videos: MP4 (1 per post, up to 5 GB)

Visibility

Control post visibility using platformSpecificData.visibility:

"PUBLIC" (default) — visible to everyone
"CONNECTIONS" — visible to connections only

curl -X POST "https://api.postpeer.dev/v1/posts" \
  -H "x-access-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "An update for my network.",
    "platforms": [
      {
        "platform": "linkedin",
        "accountId": "li_123",
        "platformSpecificData": {
          "visibility": "CONNECTIONS"
        }
      }
    ],
    "publishNow": true
  }'

Tag a company page in the post text using platformSpecificData.mentions. LinkedIn's API only supports mentioning organization/company pages, not personal profiles. Each entry maps an exact substring of content to the organization URN to mention; LinkedIn renders it as a clickable @mention. The text must appear exactly once in content, case-sensitive.

curl -X POST "https://api.postpeer.dev/v1/posts" \
  -H "x-access-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Great working with Acme Corp on this launch!",
    "platforms": [
      {
        "platform": "linkedin",
        "accountId": "li_123",
        "platformSpecificData": {
          "mentions": [
            { "text": "Acme Corp", "urn": "urn:li:organization:2414183" }
          ]
        }
      }
    ],
    "publishNow": true
  }'

Find a company's organization URN from its LinkedIn page URL or via the Connect Accounts integration data.

Platform-Specific Data

Pass this object in platformSpecificData when posting to LinkedIn.

Field	Type	Required	Values and constraints	Description
`visibility`	string	No	`PUBLIC`, `CONNECTIONS`	Post visibility. "PUBLIC" = visible to everyone, "CONNECTIONS" = visible to connections only. Defaults to "PUBLIC".
`mentions`	object[]	No	Items: 0–30	Tag company pages in the post text. Each entry maps an exact substring of `content` to the organization URN to mention; LinkedIn renders it as a clickable @mention. Only company pages can be mentioned, not personal profiles.
`mentions[].text`	string	Yes, in each `mentions[]` item	Length: 1–unbounded	Exact substring within the post content to turn into a clickable mention (e.g. "Acme Corp"). Case-sensitive, must appear exactly once in content.
`mentions[].urn`	string	Yes, in each `mentions[]` item	—	LinkedIn URN of the company page to mention, e.g. "urn:li:organization:12345". LinkedIn's API only supports mentioning organization/company pages, not personal profiles.
`articleUrl`	string	No	Format: `uri`	URL for an article/link post. When provided, the post becomes a link share with a preview card.
`articleTitle`	string	No	Length: 0–400	Title for the article preview card. Max 400 characters.
`articleDescription`	string	No	Length: 0–400	Description for the article preview card. Max 400 characters.
`documentTitle`	string	No	Length: 0–200	Title shown on the document card when posting a PDF. Required by LinkedIn when a document media item is included.

Limits

Limit	Value
Character limit	3,000 per post
Images per post	9
Videos per post	1
Max video size	5 GB
Max image size	10 MB