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

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

  • 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.

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.