Postproxy × LinkedIn

Publish posts to LinkedIn personal profiles or company pages. Handle organization posting and media constraints seamlessly.

One API call handles both personal and organization posting on LinkedIn.

Organization Posts

Post on behalf of LinkedIn company pages

Rich Media

Support for images (up to 20), videos (up to 15 min), and documents

Professional Network

Publish to the world's largest professional network

Video Support

Upload videos up to 5 GB with professional formatting

POST /v1/posts
Terminal window
curl -X POST "https://api.postproxy.dev/api/posts" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"post": {
"body": "We are excited to share our latest product update with the community!"
},
"profiles": ["linkedin"],
"media": ["https://example.com/image.jpg"],
"platforms": {
"linkedin": {
"organization_id": "12345678"
}
}
}'

LinkedIn Parameters

Formats

Format Description
post Feed post (default)

Parameters

Parameter Type Required Description
organization_id string No Post on behalf of an organization/company page

Media Constraints

Media Type Max Size Formats Max Count Duration
Image 8 MB jpg, png, gif 20 -
Video 5 GB mp4, mov, avi 1 0 - 15min
Document 100 MB pdf, doc, docx, ppt, pptx 1 -

Notes

  • Text content: Optional
  • Media required: No
  • Mix video and image: No
  • Mix documents with images/videos: No
  • Minimum image dimensions: 552x276 pixels
  • Document max pages: 300

View full documentation for all platform-specific features for LinkedIn

Why Postproxy for LinkedIn?

Skip LinkedIn API complexity

No need to handle LinkedIn OAuth flows, organization permissions, or API rate limits. Postproxy handles it all.

Handle rate limits automatically

LinkedIn rate limits are managed automatically with intelligent retry logic.

Support all formats

Publish text posts, images, videos, and documents to personal profiles or company pages.

Supported formats:
Feed posts

Reliable delivery

Automatic retries and clear status reporting ensure your content reaches LinkedIn.

How LinkedIn Publishing Works with Postproxy

LinkedIn's publishing model

LinkedIn's API distinguishes between personal profiles and organization pages, each with different endpoints, permission scopes, and content capabilities. Publishing to an organization page requires separate OAuth authorization with the w_organization_social scope, and the API uses a UGC (User Generated Content) post format that differs from the personal share format. Postproxy abstracts this — you specify a profile ID and post content, and the API routes to the correct LinkedIn endpoint based on the account type.

Media uploads and document sharing

LinkedIn's media upload process requires registering an upload, uploading the binary to a LinkedIn-provided URL, then referencing the asset URN in your post. For images, the upload is straightforward, but videos require a chunked upload protocol with status polling. Postproxy handles the full upload lifecycle — pass media URLs in your request and the registration, upload, and asset referencing happen automatically.

Common gotchas Postproxy handles for you

LinkedIn's API has several non-obvious constraints: text posts are limited to 3,000 characters, image posts max out at 20 images, and video posts have strict codec requirements (H.264 video, AAC audio). The API also enforces rate limits per organization and returns opaque error codes when limits are hit. Postproxy validates content against these constraints before sending to LinkedIn and provides clear error messages when limits would be exceeded.

Personal profiles vs. company pages

One of the trickiest parts of LinkedIn integration is handling the difference between personal and organization posting. The API schemas, permission models, and content capabilities differ between the two. With Postproxy you connect both account types through the same OAuth flow, and the API automatically uses the correct LinkedIn endpoint and payload format based on which profile you're posting to.

Frequently Asked Questions

Common questions about LinkedIn integration

Can I post on behalf of an organization or company page?

Yes! Use the `organization_id` parameter in the platforms object to post on behalf of a LinkedIn company page. If omitted, the post will be published from your personal profile.

What media constraints apply to LinkedIn posts?

LinkedIn supports images (jpg, png, gif) up to 8 MB with up to 20 images per post, videos (mp4, mov, avi) up to 5 GB with a maximum duration of 15 minutes, and documents (pdf, doc, docx, ppt, pptx) up to 100 MB with a maximum of 300 pages. Images must be at least 552x276 pixels.

Are videos supported on LinkedIn?

Yes! LinkedIn supports video posts up to 5 GB in size and up to 15 minutes long. Videos must be in mp4, mov, or avi format.

Can I post text-only content?

Yes! LinkedIn supports text-only posts without any media. Simply omit the media array from your post request.

Can I mix videos and images in a single post?

No, LinkedIn does not allow mixing videos and images in a single post. You can post multiple images (up to 20) or a single video. Documents must also be posted alone without other media.

Can I upload documents to LinkedIn?

Yes! LinkedIn supports document uploads (PDF, DOC, DOCX, PPT, PPTX) up to 100 MB and 300 pages. Documents must be posted alone — you cannot mix them with images or videos.

Ready to get started?

Start with our free plan and scale as your needs grow. No credit card required.