LinkedIn API

Postproxy publishes feed posts to a LinkedIn personal profile or a company page (organization), including image, video, and document (PDF/slide) posts.

Every request below uses the base URL https://api.postproxy.dev and an Authorization: Bearer YOUR_API_KEY header. Replace YOUR_API_KEY and the example IDs with your own.

At a glance

Platform ID	linkedin
Formats	post (default)
Character limit	3,000
Media	Optional
Placements	Personal profile + organizations — selected with organization_id
Comments	Coming soon
Direct messages	No
Post chains	No

Publishing

Parameters

Parameter	Type	Required	Description
organization_id	string	No	Post as a company page. Omit to post on the personal profile

Media	Max size	Formats	Count	Duration
Image	8 MB	jpg, png, gif	20	—
Video	5 GB	mp4, mov, avi	1	up to 15 min
Document	100 MB	pdf, doc, docx, ppt, pptx	1	—

• Text-only posts are allowed; media is optional.
• Images and video cannot be mixed.
• A document must be posted on its own — it cannot be combined with images or video. Max 300 pages.
• Minimum image dimensions: 552×276 px.

# Post to the personal profile
curl -X POST "https://api.postproxy.dev/api/posts" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "post": { "body": "We are excited to share our latest product update!" },
       "profiles": ["prof_abc123"],
       "media": ["https://example.com/image.jpg"],
       "platforms": { "linkedin": {} }
     }'

# Post to a company page
curl -X POST "https://api.postproxy.dev/api/posts" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "post": { "body": "Hiring! We are growing the engineering team." },
       "profiles": ["prof_abc123"],
       "platforms": { "linkedin": { "organization_id": "12345678" } }
     }'

# Document (PDF carousel) — must be the only attachment
curl -X POST "https://api.postproxy.dev/api/posts" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "post": { "body": "Our 2026 industry report — free download." },
       "profiles": ["prof_abc123"],
       "media": ["https://example.com/report.pdf"],
       "platforms": { "linkedin": { "organization_id": "12345678" } }
     }'

Placements

A LinkedIn profile can publish to the personal profile and to any organizations the account administers. List them with the placements endpoint:

• The personal profile is returned with id: null.
• Each organization’s id is the value you pass as organization_id.

# List placements (personal profile + organizations)
curl "https://api.postproxy.dev/api/profiles/prof_abc123/placements" \
     -H "Authorization: Bearer YOUR_API_KEY"

Omit organization_id to publish on the personal profile.

Comments

Coming soon. Comment list, reply, hide, and delete support for LinkedIn is in progress. When live, comments will be managed through the Comments API.

Direct messages

Not supported.

Webhooks

Subscribe with the Webhooks API:

curl -X POST "https://api.postproxy.dev/api/webhooks" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "url": "https://example.com/webhooks/postproxy",
       "events": ["platform_post.published", "platform_post.insights", "profile.stats"]
     }'

Events relevant to LinkedIn:

Event	When
post.processed	A post is ready to publish
platform_post.published	A post was published to the platform
platform_post.failed	A post failed to publish (retries exhausted)
platform_post.failed_waiting_for_retry	A publish attempt failed; will retry
platform_post.insights	New analytics snapshot
profile.connected / .disconnected	Connection state changed
profile.stats	New profile stats snapshot — fires once per placement (personal profile + each organization)
media.failed	A media attachment failed to process

Notes

• Choose the audience with organization_id: present → company page, absent → personal profile.
• Document posts (PDF, DOCX, PPTX) render as LinkedIn’s native multi-page carousel and must be the only attachment.