LinkedIn is where you usually want cleaner formatting, longer copy, and more explicit control over audience-facing metadata. UniPost keeps that complexity under `platform_options.linkedin` while preserving one core publish shape.
Overview
LinkedIn supports text-only posts, multi-image posts, video posts, and first comments. It does not behave like a Twitter-style thread platform, so longer narratives should usually be published as one longer caption.
Supported capabilities
| Capability | Supported | Notes |
|---|---|---|
| Text posts | ✓ | Up to 3,000 characters |
| Image posts | ✓ | Up to 9 images |
| Video posts | ✓ | Exactly 1 video |
| Threads | X | Publish as separate posts instead |
| First comment | ✓ | Supported |
| Visibility options | ✓ | Use `platform_options.linkedin` |
Requirements
| Field | Required | Limits | Notes |
|---|---|---|---|
| caption | Optional | 3,000 chars | Best for longer release notes and announcements |
| media_urls | Optional | 1-9 images OR 1 video | Do not mix images and video |
| platform_options.linkedin | Optional | visibility | Use for audience controls |
| first_comment | Optional | text | Posted after the main post lands |
Platform-specific options
| Option | Values | Notes |
|---|---|---|
| platform_options.linkedin.visibility | anyone / connections | Set post audience visibility |
Example requests
The examples below are intentionally small and copyable. They show the request body only, assuming a standard POST /v1/social-posts call with Bearer auth.
Long-form text post
{
"caption": "We shipped a new release today with managed Connect, preview links, and post validation.",
"account_ids": ["sa_linkedin_1"]
}Multi-image post
{
"caption": "Recap of our launch event",
"account_ids": ["sa_linkedin_1"],
"media_urls": [
"https://cdn.example.com/event-1.jpg",
"https://cdn.example.com/event-2.jpg",
"https://cdn.example.com/event-3.jpg"
]
}Video post
{
"caption": "Customer story 🎬",
"account_ids": ["sa_linkedin_1"],
"media_urls": ["https://cdn.example.com/story.mp4"]
}Common validation errors
| Code | What it means |
|---|---|
| caption_too_long | Caption exceeds 3,000 characters |
| too_many_media | More than 9 images supplied |
| mixed_media_unsupported | LinkedIn does not accept image and video in the same share |
Related reference
Once you know the correct request shape for this platform, move to the API reference for the full endpoint contract, response schema, and validation payload shape.