Posts
Publish to a LinkedIn personal profile via API
A POST /posts with the linkedin_personal connection publishes to the personal profile the person connected. Your product doesn't implement LinkedIn OAuth or store tokens: it sends the content and Connect publishes it in the background, with the same body used for pages.
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-7002",
"format": "feed",
"caption": "Three lessons from a year of building in public.",
"media": [
{
"type": "image",
"url": "https://cdn.example.com/lessons.png",
"alt_text": "Slide with three lessons"
}
]
}What you can do
- Publish plain text, with a caption of up to 3000 characters.
- Publish 1 to 20 images, with optional alt_text.
- Publish 1 video, with an optional title in linkedin.title.
- Publish 1 document, with linkedin.title required.
- Pick the profile 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
Personal branding tool
Executives connect their personal profile and the product publishes the posts approved by the content team.
Sales and social selling platform
Sales reps publish company content on their own profile from the CRM, one connection per person.
AI agent for creators
An agent writes the personal-profile version of the post and publishes it after the user approves.
Works with
LinkedIn Personal
Frequently asked questions
Do personal profiles and pages use the same endpoint?
Yes, POST /posts with the same body. What changes is the connection: linkedin_personal for a personal profile and linkedin for pages.
Can I publish an image carousel?
Yes, 2 to 20 images in the same post. A video or document only works alone in the post.
What if the same post is sent twice?
The Idempotency-Key returns the already stored post, and external_reference returns 409 if the same post is publishing or was already published on the account.
See Connect applied to your product.
Try it for 15 days with no card, or walk our team through your use case.
