Post to LinkedIn

Creates a LinkedIn post on a profile or company page with visibility control (PUBLIC or CONNECTIONS). The schedule field works like createPost. Send an Idempotency-Key header to make retries safe.

Authorization

api-key

AuthorizationBearer <token>

Workspace API key (nim_live_...)

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

channelId*string

LinkedIn channel id (must be a LINKEDIN_PROFILE or LINKEDIN_PAGE channel from GET /v1/channels)

content*string

Post text (max 3000 characters)

mediaIds?array<string>

Media ids in display order: up to 20 images or 1 video (upload via POST /v1/media first)

visibility?string

Who can see the post: everyone (PUBLIC, default) or 1st-degree connections only (CONNECTIONS, personal profiles only)

Default"PUBLIC"

Value in

"PUBLIC"
"CONNECTIONS"

schedule?string

When to publish: "draft" (default, create only), "next_slot" (next free posting-schedule slot), "now" (publish immediately), or an ISO 8601 datetime. Anything except "draft" requires the posts:publish scope.

Response Body

`application/json`

curl -X POST "https://example.com/v1/posts/linkedin" \  -H "Content-Type: application/json" \  -d '{    "channelId": "123e4567-e89b-12d3-a456-426614174000",    "content": "string"  }'

{  "id": "123e4567-e89b-12d3-a456-426614174000",  "channelId": "123e4567-e89b-12d3-a456-426614174000",  "content": "Launching something new today 🚀",  "title": null,  "contentType": "POST",  "status": "SCHEDULED",  "scheduledAt": "2026-08-01T09:00:00.000Z",  "publishedAt": null,  "createdAt": "2026-07-05T10:00:00.000Z",  "mediaIds": [    "string"  ]}

Empty

Post to LinkedIn

Authorization

Request Body

Response Body

201application/json

400

`application/json`