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

FieldTypeRequiredDescription
external_referencestringYesThe post's id in your system (up to 100 characters). Stops the same post from being published twice on the same account.
formatstringYesAlways feed on LinkedIn.
captionstringNoThe post text, up to 3000 characters. Required when there is no media.
mediaarrayNoImages (1 to 20), or 1 video, or 1 document. A video or document cannot be mixed with other media.
media.typestringYesimage, video or document. A document (for example a PDF) only exists on LinkedIn.
media.urlstringYesA public https:// URL the network can download.
linkedin.titlestringNoTitle 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.

Related

See everything you can do with Posts

See Connect applied to your product.

Try it for 15 days with no card, or walk our team through your use case.