LinkedIn

LinkedIn is where you usually want cleaner formatting, longer copy, and explicit audience controls. UniPost keeps that complexity under `platform_options.linkedin` while preserving one core publish shape.

Long-form text, multi-image, and first-comment posts with audience controls.

At a glance

Publishing
Supported
Scheduling
Supported
Analytics
Supported
Inbox
Not supported
Connection
OAuth — Quickstart and White-label both supported

Feature matrix

FeatureSupportNotes
Text postsUp to 3,000 characters
Image postsUp to 9 images
Video postsExactly 1 video
First commentSupported
SchedulingUse scheduled_at
Visibility optionsUse platform_options.linkedin
ThreadsXPublish as separate posts instead
Inbox / DMsXNot part of the UniPost inbox today

Known constraints

LimitationWhy
Daily safety cap50 publishes/day per connected LinkedIn account (UTC reset). Failed posts do not count toward the cap.
No thread-style postingLinkedIn is a single-post surface — use longer copy instead
Mixed media not allowedEither images OR video, never both in one share
No inbox surfaceDMs and comment moderation are not in UniPost inbox today

Publishing

Ready to publish?Use the shared Publishing guide for hosted URLs, local file uploads, preflight validation, and async publish status. Then use the LinkedIn examples below for platform-specific payload shape.

Publish examples by surface

Each example calls POST/v1/posts with Bearer auth. Swap the account_ids for your own, then copy the snippet for your language.

Long-form text post

Multi-image post

Video post

Media & field requirements

FieldRequiredLimitsNotes
captionOptional3,000 charsBest for longer release notes and announcements
media_urls or media_idsOptional1-9 images OR 1 videoUse media_urls for hosted assets or media_ids for local files uploaded via POST/v1/media. Do not mix images and video.
platform_options.linkedinOptionalvisibilityUse for audience controls
first_commentOptionaltextPosted after the main post lands

Hosted URLs: pass the public URL in media_urls. Local files: reserve an upload with POST/v1/media, PUT the bytes to the returned upload_url, then publish with media_ids. Full flow in the Publishing guide.

Media specifications

Per-surface limits for text, images, and video. These are the source of truth UniPost uses for preflight validation and media optimization — treat hard-limit values as enforced and "recommended" values as platform guidance.

Feed post

Default share type for a LinkedIn member or organization. Supports text, image, and video.

TypeRequirementValue
TextCharacter limit3,000 chars
TextVisible before fold≈210 chars before the 'see more' cut
TextHashtags / mentionsCount inside the 3,000 budget; ≤ 5 hashtags recommended
ImageFormatsJPEG, PNG
ImageMax per post20 (multi-image / document-like share); 9 commonly used
ImageMax file size8 MB per image
ImageDimensionsMin 552 × 276 px, max 8,192 × 8,192 px
ImageRecommended ratios1.91:1 (1,200 × 627), 1:1 (1,080 × 1,080), 4:5 (1,080 × 1,350)
VideoFormatsMP4, MOV
VideoMax per post1
VideoMax file size5 GB
VideoDuration3 sec – 10 min (member page), 3 sec – 30 min (organization page)
VideoDimensionsMin 256 × 144 px, max 4,096 × 2,304 px
VideoAspect ratio range1:2.4 to 2.4:1; 16:9 or 1:1 recommended
VideoFrame rate10 – 60 fps
VideoBitrate10 – 30 Mbps (H.264 high profile)
VideoAudioAAC stereo, ≤ 192 kbps

Document post

Carousel-style PDF that LinkedIn renders inline. Not exposed via UniPost today — listed for completeness.

TypeRequirementValue
TextCharacter limit3,000 chars (same as feed)
ImageFormatsPDF, PPT, PPTX, DOC, DOCX
ImageMax per post1 document
ImageMax file size100 MB
ImageMax pages300

Platform-specific options

OptionValuesNotes
platform_options.linkedin.visibilityanyone / connectionsSet post audience visibility

Analytics

MetricSupportNotes
ImpressionsSupported
ReachSupported
LikesSupported
CommentsSupported
SharesSupported
ClicksSupported
SavesXNot exposed by LinkedIn
Video viewsXNot exposed per-post today

Connection modes

Pick the setup that matches how the account is owned. Quickstart is fastest when you publish to your own accounts; White-label is required when your customers bring their own accounts through a branded flow. Full setup details in Quickstart and White-label.

ModeBest forApp / credentialsAvailability
QuickstartFast setup — UniPost handles OAuthUniPost-managed appFree / paid quota
White-labelYour customers connect their own accountsYour OAuth appPaid plans only

Validation errors

CodeWhat it means
caption_too_longCaption exceeds 3,000 characters
too_many_mediaMore than 9 images supplied
mixed_media_unsupportedLinkedIn does not accept image and video in the same share

Next steps