Skip to main content
POST
Create Post
Publishes a post as the connected account. Write action, and the result is publicly visible on LinkedIn, so treat it as irreversible. The request must be multipart/form-data: a JSON body is rejected while upstream parses attachments. Add an image with -F "attachments=@image.jpg", mention someone by putting {{0}} in the text and passing mentions[0][profile_id] / mentions[0][name], or post on behalf of a company you administer by passing as_organization with the company id. Reference price: $0.02 USD per successful request.

Example

Path parameters and required query parameters are documented in the operation reference.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

multipart/form-data
account_id
string
required

Connected account id the post is published from.

text
string
required

Post body. Use {{0}} placeholders to reference entries of the mentions array.

attachments
file[]

Files to attach, one -F "attachments=@file" per file. Either several images or a single file of another type; images are capped at 6012x6012 px.

URL rendered as a preview card. Must also appear in text or it is appended automatically.

as_organization
string

Company id to publish on behalf of. Your account must administer that company page.

Response

Success

object
enum<string>
Available options:
PostCreated
post_id
string

Id of the published post.