LinkedIn API for developersThe LinkedIn Profile API,without the app review
Publish posts, PDF document carousels, polls and links to your personal profile, with the link in a first comment. Read what each post reached. One API key, on OmniSocials’ approved LinkedIn app.
Webhooksyour-app.com/hooks
post.scheduledpost 1024just now200
post.publishedpost 10192 h ago200
post.approvedpost 10193 h ago200
POST/v1/posts/createapplication/json
01{
02 "content": "SDKs in 8 languages. Docs in the first comment.",
03 "accounts": ["linkedin"],
04 "media_urls": ["https://cdn.example.com/sdks.jpg"],
05 "schedule_at": "2026-10-22T18:00:00Z",
06 "linkedin": {
07 "first_comment": "https://omnisocials.com/sdk"
08 }
09}
Sending201 Created412 ms
Send10{
11 "data": {
12 "id": "1024",
13 "status": "scheduled",
14 "app_url": "https://app.omnisocials.com/create-post/1024"
15 }
16}
A request creates a LinkedIn profile post with a first comment for Thu 22 at 18:00; it appears in the OmniSocials calendar and the webhook post.scheduled fires.
Your coding agent runs the same calls through the CLI
Skip the LinkedIn app review
LinkedIn’s own API needs a developer app, the Community Management API approved, twelve scopes and a token refresh before day 60. Then come Development tier quotas and the upload steps for images, documents and video. OmniSocials already did that work.
On your own
w_member_socialr_member_postAnalyticsr_member_profileAnalyticsr_organization_followers
w_member_social_feedr_1st_connections_sizer_basicprofiler_organization_social_feed
w_organization_socialr_organization_socialrw_organization_adminw_organization_social_feed
LinkedIn appApp reviewDev tierTokensVersionsUploadsPollingPDFsFirst postOn OmniSocials
Sign inAPI keyPOSTFirst postAll 12 scopes already approvedEvery format, one request
Text, an image, a video, a PDF document, a poll or a link card share one request shape. Add media URLs, a poll or a link and a time. OmniSocials checks the post against LinkedIn’s rules before it uploads.
Robert Ligthart
Now
Like
Comment
Repost
Send
POST/v1/posts/create
01{
02 "content": "SDKs in 8 languages. Docs in the first comment.",
03 "accounts": ["linkedin"],
04 "media_urls": ["https://cdn.example.com/sdks.jpg"],
05 "schedule_at": "2026-10-22T18:00:00Z",
06 "linkedin": {
07 "first_comment": "https://omnisocials.com/sdk"
08 }
09}
201 Createdstatus: "scheduled"
Posts and first comments
Text with an image or a video. Put the link in a first comment, posted as you right after the post goes live.
media_urlslinkedin.first_comment
Documents
Two or more images go out as a swipeable PDF document. A PDF you send goes out as the original file.
media_urlslinkedin.document_source
Polls
A question, 2 to 4 options and a duration from 1 day to 2 weeks. A poll can’t carry media or a link card.
linkedin_poll
Document carousels, without the PDF work
LinkedIn has no image carousel. Send two or more images and OmniSocials builds the swipeable PDF document. Send a PDF and LinkedIn gets the original file. Or post the images as a gallery.
Robert Ligthart
Now
Sidebar update: a new Home tab, and more. · 2 pages
Sidebar update: a new Home tab, and more. · 2 pages
LikeCommentRepostSendPOST/v1/posts/create
01{
02 "content": "Sidebar update: a new Home tab, and more.",
03 "accounts": ["linkedin"],
04 "media_urls": ["https://cdn.example.com/sidebar.pdf"],
05 "schedule_at": "2026-10-24T09:00:00Z",
06 "linkedin": {
07 "document_source": "original_pdf"
08 }
09}
201 Createdstatus: "scheduled"
Original PDF
Send a PDF URL and LinkedIn gets the file itself, with sharp text, working links and up to 300 pages. Other channels get its pages as images.
media_urlslinkedin.document_source
Document carousel
Two or more images become one swipeable PDF document, titled with the caption’s first line. For a PDF, slides rebuilds it from the page images.
document_source: "slides"
Image gallery
Prefer LinkedIn’s classic multi-image post? Set carousel_as_images and the images go out as a gallery instead.
carousel_as_images: true
Connect your profile once, post from code
Sign in with LinkedIn once inside OmniSocials. Create an API key, and your code posts and reports for your profile.
OmniSocials
Name, icon, social channels and who can open this workspace.
GeneralMembersClientsApproval workflowsAPI
Workspace iconJPG or PNG, up to 2 MB.
Workspace nameOmniSocials
Social channels
The accounts this workspace posts to.
Connected
@omnisocials_
Instagram
@omnisocials_
Threads
OmniSocials
LinkedIn Page
@omnisocials_
X
Add a channel
LinkedIn ProfilePosts & Carousels
FacebookPosts, Stories & Reels
YouTubeShorts
TikTokVideos & Photo posts
PinterestPins & Carousels
BlueskyPosts & Threads
MastodonAny server
Google BusinessUpdates, Events & Offers
TelegramChannels and groupsComing soon
Danger zone
Delete workspace
Deletes this workspace with its posts, media and settings for good. This cannot be undone.
OmniSocials
Name, icon, social channels and who can open this workspace.
GeneralMembersClientsApproval workflowsAPI
API keys
Keys that can only reach this workspace.
| Name | Key | Last used | |
|---|---|---|---|
Claude | omsk_live_••••7c2e | Oct 20, 2026 |
GET/v1/accounts?platform=linkedin
200 OK88 ms
01{
02 "data": [
03 {
04 "id": "4127_linkedin",
05 "platform": "linkedin",
06 "display_name": "Robert Ligthart",
07 "content_types": ["post"],
08 "status": "active"
09 }
10 ],
11 "workspace_name": "OmniSocials"
12}
Authorization: Bearer $OMNISOCIALS_API_KEY
LinkedIn sign-in
Sign in with LinkedIn and your profile connects, no picker. Your Company Page is a channel of its own.
A key per workspace
A key only reaches its own workspace. Each workspace connects one personal profile.
What the profile can post
The accounts call lists the profile with the formats it takes, and says when it needs a reconnect.
GET /v1/accountscontent_types
“The MCP is the real game changer for me. It makes the whole workflow feel much faster and less messy.”
Ansub Khan
Founder of Supafast
Read what LinkedIn reports
Impressions, members reached, reactions by type, comments, reposts, saves, sends and link clicks per post. The API returns the same numbers the app charts.
AnalyticsReports
All
Impressions
7,00519.3%
Reach
4,99918.7%
Engagements
36125.8%
Engagement Rate
5.2%0.3pt
Posts8Accounts8
Post | Channels | Impressions | Reach | Likes | Comments | Shares | Saves | Eng. rate | |
|---|---|---|---|---|---|---|---|---|---|
 New: 1GB video uploads Oct 21, 2026 | | 212 | 168 | 9 | 1 | 0 | 1 | 4.7% | |
 New in OmniSocials: Notable Days Oct 20, 2026 | | 846 | 603 | 27 | 4 | 2 | 5 | 5.0% | |
 New: Alt text on every image Oct 19, 2026 | | 1.3K | 917 | 41 | 7 | 3 | 9 | 5.4% | |
 New: LinkedIn in the Social Inbox Oct 14, 2026 | | 1K | 744 | 33 | 6 | 4 | 7 | 5.5% | |
 New: PDF uploads Oct 7, 2026 | | 1.5K | 1K | 52 | 9 | 6 | 14 | 5.8% | |
Building on OmniSocials? Start with the API docs. Oct 2, 2026 | | 638 | 471 | 18 | 5 | 1 | 2 | 5.5% | |
 New: Mastodon threads Sep 29, 2026 | | 774 | 552 | 22 | 3 | 2 | 3 | 4.3% | |
 New: Bluesky threads Sep 24, 2026 | | 702 | 498 | 19 | 2 | 1 | 2 | 3.8% |
GET/v1/analytics/posts/1019
Authorization: Bearer $OMNISOCIALS_API_KEY
200 OK143 ms
01{
02 "data": {
03 "post_id": "1019",
04 "platforms": {
05 "linkedin": {
06 "metrics": {
07 "impressions": 1284, "reach": 917,
08 "likes": 41, "comments": 7,
09 "shares": 3, "saves": 9, "sends": 4,
10 "clicks": 18, "link_clicks": 18,
11 "follows": 2, "profile_visits": 23,
12 "reactions": {
13 "like": 31, "praise": 6,
14 "empathy": 2, "interest": 2
15 }
16 }
17 }
18 }
19 }
20}
Per post
Impressions, reach, reactions by type, comments, shares, saves, sends, link clicks, follows and profile visits. Videos add views and watch time.
/analytics/posts/:id
Per profile and workspace
The profile’s followers and its daily impressions, likes, comments and shares. Plus a workspace overview.
/analytics/accounts/analytics/overview
Best times to post
Days and hours worked out from your own LinkedIn history, once 15 of your posts are analyzed.
/analytics/best-times
Under the hood
Built for production
Signed webhooks, automatic retries, SDKs in 8 languages and a key per workspace. Create a key and send your first request in minutes.
LinkedIn’s rules, in one place
OmniSocials checks every post against them before it reaches LinkedIn, so a bad file fails in your request, not at publish time.
Text3,000 characters
First comment1,250 characters
ImagesJPEG, PNG, GIF or WebP, up to 10 MB each
MediaImages or one video per post, not both
PDF documentsThe original file up to 100 MB, 300 pages
VideoMP4 or MOV, up to 30 minutes
PollA 140-character question, 2 to 4 options of 30
Poll length1 day, 3 days, 1 week or 2 weeks
Rate limit100 requests a minute per API key
AccountsOne personal profile per workspace
Your first LinkedIn post in three steps
About five minutes from sign-up to a scheduled post on your profile. Then hand the key to your coding agent.
Create an API key
Start your trial, open Settings, API and create a key. It is shown once.
Settings › APIStep 1
Connect your profile
Sign in with LinkedIn in OmniSocials once. Then list the profile from your code.
GET /v1/accountsStep 2
Send your first post
Post now with create-and-publish, or add schedule_at to plan it.
POST /v1/posts/createStep 3
Frequently
Asked Questions
Robert LigthartFounder of OmniSocials
Ship your LinkedIn
integration this week.
From $10 per seat a month, API included. 14-day free trial.
https://docs.omnisocials.com