LinkedIn API Reference

Post text, images, video, and GIFs to LinkedIn profiles and organizations.

Quick reference

auth	OAuth 2.0
text Limit	3,000 characters
max Media	1 item
media Rule	Only 1 media item per post (no carousel)
max Video Duration	10 min
entity Selection	LinkedIn Organizations
first Comment	Supported — 1,500 chars

Content types

✓Text

Up to 3,000 characters

✓Images

JPEG, PNG, GIF. Max 10 MB. Only 1 per post.

✓Video

MP4 only. Max 5 GB. Up to 10 minutes.

—Carousel

Not supported via API (single media only)

✓GIF

Animated GIFs supported

Media requirements

Constraints enforced by LinkedIn's API. Requests that violate these limits will be rejected.

Constraint	Value
Max image size	`10 MB`
Max video size	`5 GB`
Image formats	`JPEG, PNG, GIF`
Video formats	`MP4`
Max video duration	`10 min`
Image aspect ratio	`0.42:1 to 2.40:1`
Min image dimensions	`200x200 px`
Max media items	`1`
GIF support	`Yes`

Platform settings

Pass these fields inside platformSettings.linkedin in the request body.

Name	Type	Required	Description
`documentTitle`	`string`	Optional	Title for PDF carousel posts (when media is a PDF document). Max 200 characters.

documentTitle

stringOptional

Title for PDF carousel posts (when media is a PDF document). Max 200 characters.

Code examples

Basic post

curl -X POST https://schedulala.com/api/v1/posts \
  -H "Authorization: Bearer sk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Thrilled to share our latest milestone!",
    "platforms": [
      { "platform": "linkedin", "accountId": "acc_li" }
    ],
    "publishNow": true
  }'

Post with media

curl -X POST https://schedulala.com/api/v1/posts \
  -H "Authorization: Bearer sk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Our new office space!",
    "platforms": [
      { "platform": "linkedin", "accountId": "acc_li" }
    ],
    "mediaItems": [
      { "type": "image", "url": "https://example.com/office.jpg" }
    ],
    "publishNow": true
  }'

Quirks & gotchas

Only 1 media item per post — no carousel via the API.

Video max: 5 GB — largest among all platforms.

Image aspect ratio: 1:2.4 to 2.4:1.

Minimum image dimensions: 200x200 px.

Entity selection: you can post as a LinkedIn Organization by selecting one after connecting.

Posts API — Create and schedule posts across all platforms Media API — Platform-specific media constraints and upload limits Connecting Accounts — OAuth, App Password, and Bot Token flows All Platforms — Compatibility matrix and overview of all 12 platforms