Skip to main content

​
Overview

Postiz enables professional content sharing on LinkedIn with support for personal profiles and company pages, including images, videos, documents, and carousel posts.

​
Authentication

LinkedIn uses OAuth 2.0 with refresh tokens for long-term access.
1

Connect LinkedIn

Click “Connect LinkedIn” in Integrations
2

Authorize Access

Grant all requested permissions for full functionality
3

Account Ready

Your LinkedIn profile is now connected

​
Required Permissions

  • openid - Basic authentication
  • profile - Profile information
  • w_member_social - Post as member
  • r_basicprofile - Read profile
  • rw_organization_admin - Manage company pages
  • w_organization_social - Post to company pages
  • r_organization_social - Read company data
Tokens are automatically refreshed by Postiz to maintain continuous access.

​
Supported Features

​
Content Types

  • Maximum: 3000 characters
  • Rich text with special character escaping
  • Company mentions supported
  • URLs automatically linked

​
Media Requirements

LinkedIn Media Rules:
  • Maximum 1 video when selecting video type
  • Minimum 2 images for carousel posts (images only)
  • Cannot mix images and videos
  • If uploading a video, only one attachment allowed

​
Advanced Features

Convert multiple images into a professional PDF carousel:
1

Enable Carousel Mode

Select “Post as Images Carousel” in settings
2

Upload Images

Add 2+ images to your post
3

Automatic Conversion

Images are automatically converted to a single PDF
4

Custom Title

Optionally set a custom carousel name
PDF carousels maintain the largest image’s dimensions and center smaller images within the same page size.

​
Company Mentions

Mention companies in your posts: 
// Format: @[Company Name](urn:li:organization:{id})
"Check out @[Microsoft](urn:li:organization:1234) latest product!"
Search for companies by vanity name: 
POST /company
{
  url: "https://www.linkedin.com/company/microsoft"
}

​
Post Comments

Add comments to LinkedIn posts:
  • Personal or company page comments
  • Support for different account types
  • Multi-account commenting with Post Plugs

​
Post Plugs

Boost engagement by commenting from multiple LinkedIn accounts:
{
  identifier: 'linkedin-add-comment',
  comment: "Great insights!"
}
Share your post to other connected LinkedIn accounts/pages:
{
  identifier: 'linkedin-repost-post-users'
}

​
Media Upload Process

​
Image Upload

1

Initialize Upload

Request upload URL from LinkedIn API
2

Process Image

Convert to JPEG, resize to 1000px width
3

Upload

Upload processed image in chunks (2MB max)

​
Video Upload

1

Initialize Upload

Request video upload endpoint
2

Upload Chunks

Upload video in 2MB chunks
3

Collect ETags

Store ETag from each chunk upload
4

Finalize

Finalize video with all ETags
Large files are automatically split into 2MB chunks for reliable upload.

​
Rate Limits

LinkedIn Rate Limits:
  • Maximum 2 concurrent posting jobs
  • Professional posting limits apply
  • API throttling for high-frequency posts
  • Refresh token required (wait between requests)

​
Error Handling

Common LinkedIn errors:
ErrorCauseSolution
Unable to obtain activityTemporary issueRetry automatically
Resource is forbiddenPermission issueCheck account permissions
Token expiredRefresh neededAutomatic token refresh
LinkedIn errors are automatically retried. Postiz handles “Unable to obtain activity” and “resource is forbidden” errors with automatic retry logic.

​
Text Formatting

LinkedIn requires special character escaping: 
Escaped characters: \ < > # ~ _ | [ ] * ( ) { } @

Example:
"Check this #hashtag" → "Check this \#hashtag"
"Cost: $50 (USD)" → "Cost: $50 \(USD\)"
Company mentions in the format @[Name](urn:li:organization:id) are preserved and not escaped.

​
Best Practices

Professional Tone

LinkedIn content performs best with professional, value-driven posts

Image Quality

Use high-quality images, 1200x627px recommended for best display

Hashtag Strategy

Use 3-5 relevant hashtags for optimal reach

Posting Time

Best engagement: Tuesday-Thursday, 7-8 AM and 5-6 PM

​
Troubleshooting

If uploads fail:
  • Check file size (videos can be large)
  • Verify format (JPEG for images, MP4 for video)
  • Ensure stable internet connection
  • Try again - LinkedIn may have temporary issues
If you see permission errors:
  • Verify all OAuth scopes were granted
  • Check company page admin status
  • Reconnect your account
  • Ensure organization access is enabled

Build docs developers (and LLMs) love

Get started for freeTalk to us