Posts
Publish to LinkedIn pages via API
A POST /posts with the linkedin connection publishes to the company page your customer connected. You don't go through LinkedIn OAuth or store tokens: you send the content and Connect publishes it in the background, on the same endpoint as the other networks.
The request
POST /api/posts?customer_integration=<connection uuid>
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Idempotency-Key: <unique key>
{
"external_reference": "post-7001",
"format": "feed",
"caption": "Our 2026 benchmark report is out. Download the full PDF below.",
"media": [
{
"type": "document",
"url": "https://cdn.example.com/benchmark-2026.pdf"
}
],
"linkedin": {
"title": "2026 benchmark report"
}
}What you can do
- Publish plain text, with a caption of up to 3000 characters.
- Publish 1 to 20 images in a post.
- Publish 1 video, with an optional title in linkedin.title.
- Publish 1 document (a PDF, for example), with linkedin.title required.
- Pick the page by connection (customer_integration) or by name (integration_slug and source_name).
Rules and limits
- Pages use the linkedin connection (integration_slug linkedin). Personal profiles use linkedin_personal.
- LinkedIn only has the feed format. It takes plain text (with a caption), 1 to 20 images, a single video or a single document.
- The caption goes up to 3000 characters. linkedin.title only applies to a single video or document, and is required on a document.
- POST /posts responds 202 and publishing runs afterwards. Track it with GET /posts/{uuid}.
- external_reference is required: the same reference publishing or already published on the same account returns 409. The Idempotency-Key header returns the already stored post on a repeat.
Main fields
| Field | Type | Required | Description |
|---|---|---|---|
| external_reference | string | Yes | The post's id in your system (up to 100 characters). Stops the same post from being published twice on the same account. |
| format | string | Yes | Always feed on LinkedIn. |
| caption | string | No | The post text, up to 3000 characters. Required when there is no media. |
| media | array | No | Images (1 to 20), or 1 video, or 1 document. A video or document cannot be mixed with other media. |
| media.type | string | Yes | image, video or document. A document (for example a PDF) only exists on LinkedIn. |
| media.url | string | Yes | A public https:// URL the network can download. |
| linkedin.title | string | No | Title of the video or document (up to 255 characters). Only with a single video or document; required on a document. |
Who it is for
Employer branding platform
Each customer company connects its own page and publishes jobs and news from inside your product.
Agency with many accounts
The agency dashboard publishes the same content to several clients' pages, one call per account.
Content AI agent
An agent turns a report into a PDF and publishes the document to the company page with a title and caption.
Works with
LinkedIn
Frequently asked questions
Do I need an app approved by LinkedIn?
No. The customer connects the page through Connect's connection flow and you publish with the merchant Bearer and the x-customer-token.
How do I publish a PDF?
Send one media item with type document and the https URL of the file, alone in the post, and fill linkedin.title, which is required on a document.
What is the difference from a personal profile?
A page uses the linkedin connection and a personal profile uses linkedin_personal. The POST /posts body is the same.
See Connect applied to your product.
Try it for 15 days with no card, or walk our team through your use case.
