LinkedIn supports text-only posts, 1 to 10 photos, or one video, published to the personal profile of the member who connected it. Three optional settings choose who can see the post and turn several photos into a carousel people swipe through.
Media Constraints
| Constraint | Images | Videos |
|---|---|---|
| Formats | JPEG, PNG | MP4, MOV (H.264 + AAC recommended) |
| Max file size | 8 MB | 500 MB |
| Max count per post | 10 | 1 |
| Duration | n/a | 3 seconds to 15 minutes |
| Text-only | Supported | Supported |
| Mix images + video | Not allowed | Not allowed |
Platform Settings
Optional, under platform_settings.linkedin. Leave the object out for a post anyone can see, with several photos shown as LinkedIn's grid.
| Parameter | Type | Description |
|---|---|---|
visibility | string | Who can see the post: PUBLIC (anyone, LinkedIn's default) or CONNECTIONS (the member's connections only). |
carousel | boolean | Post 2 or more photos as a swipeable carousel instead of LinkedIn's grid. Quegly turns the photos into a PDF, one photo per page, and posts it as a LinkedIn document. Ignored for one photo, a video or a text-only post. |
carousel_title | string | The title LinkedIn shows above the carousel. Required when carousel is true and the post has 2 or more photos. Up to 58 characters; runs of spaces and line breaks become one space. |
Examples
{
"type": "now",
"caption": "Three lessons from our first year of remote work, in one post. What would you add?",
"account_ids": ["linkedin-account-id"]
}{
"type": "schedule",
"scheduled_at": "2026-10-01T14:00:00.000Z",
"caption": "Three room makeovers, one afternoon. Swipe for the before and after.",
"media_ids": ["image-id-1", "image-id-2", "image-id-3"],
"account_ids": ["linkedin-account-id"],
"platform_settings": {
"linkedin": {
"visibility": "CONNECTIONS",
"carousel": true,
"carousel_title": "Three room makeovers, one afternoon"
}
}
}Caption Rules
| Max length | 3,000 characters. Longer captions are rejected before the post is saved. |
Connection
| Profiles | Personal profiles only. Quegly posts to the profile of the member who connected the account; LinkedIn Company Pages cannot be connected. |
| Name | A LinkedIn profile has no @handle: the account's account_username and display_name are the member's name. |
Each connection ends on a known date: 60 days after the account is connected today, longer once LinkedIn renews the access automatically. The account's row on the Manage page shows the date, in yellow in the last week. Reconnect the account on the Manage page before then; once the access has ended, LinkedIn posts fail until the account is reconnected. Reconnecting the same profile keeps its account ID.
Analytics
LinkedIn shares a member's post stats only with apps it approves for its Community Management API, and only once the member allows them (the r_member_postAnalytics permission, asked for when LinkedIn is connected). Once allowed, a LinkedIn post's metrics carry views, reach, likes, reactions, comments, reposts, shares (sent in LinkedIn messages), saved and url_link_clicks, and a video's watch_time_seconds; until then they are {}. LinkedIn limits its stats calls per day, so LinkedIn posts refresh on a slower cadence than the other platforms'. Its post_url links to the post on LinkedIn either way.