Create Social Post

POST

/social/posts

• Production
• QA

Create a DRAFT post. Nothing is published until you schedule or publish it.

Authorizations

• BearerAuth

Parameters

Header Parameters

X-Target-Org-Id

Any of:

string

string

null

null

Request Body ^required

A new post. Created as a DRAFT - nothing is published until you schedule or publish it.

object

account_ref

Any of:

string

string

null

null

body

required

The post text.

string

>= 1 characters <= 3000 characters

campaign_id

Any of:

string

string

null

null

generation_sources

Any of:

Array<string>

Array<string>

<= 10 items

null

null

idea_id

Any of:

string

string

null

null

idempotency_key

Any of:

string

string

<= 255 characters

null

null

media

Any of:

Array<object>

Array<object>

<= 9 items

One image, video or PDF document attached to a post.

A post carries up to 8 images, OR exactly one video, OR exactly one document, never a mix.

object

alt

Alt text. alt_text is accepted as a synonym.

string

""

duration_seconds

Display only: video length in seconds.

id

Any of:

string

string

null

null

kind

image, video or document (a PDF).

string

default: image

page_count

Display only: number of pages of a document.

poster_url

Any of:

string

string

<= 2048 characters

null

null

size_bytes

Display only: file size in bytes. Never sent to LinkedIn.

title

Any of:

string

string

null

null

url

required

Publicly fetchable URL of the asset.

string

null

null

post_type

string

default: text

Allowed values: text image video document

Responses

201

Successful Response

object

data

required

One post.

object

account_ref

Any of:

string

string

null

null

autopilot_config_id

Any of:

string

string

null

null

autopilot_version

Any of:

integer

integer

null

null

body

required

string

campaign_id

Any of:

string

string

null

null

created_at

Any of:

string

string

null

null

created_by

required

string

external_post_id

Any of:

string

string

null

null

external_post_url

Any of:

string

string

null

null

failure_reason

Any of:

string

string

null

null

generation_metadata

Any of:

object

object

key

additional properties

any

null

null

generation_sources

Any of:

Array<string>

Array<string>

null

null

id

required

string

idea_id

Any of:

string

string

null

null

media

Any of:

Array<object>

Array<object>

object

key

additional properties

any

null

null

post_type

required

string

provider

Any of:

string

string

null

null

published_at

Any of:

string

string

null

null

scheduled_at

Any of:

string

string

null

null

status

required

string

updated_at

Any of:

string

string

null

null

pagination

Any of:

PaginationMeta

object

has_next

required

Whether there are more pages

boolean

limit

required

Items per page

integer

next_cursor

Any of:

string

string

null

null

notes

Any of:

Array<string>

Array<string>

null

null

page

required

Current page number (1-indexed)

integer

total

required

Total number of items

integer

total_available

Any of:

integer

integer

null

null

total_is_lower_bound

Any of:

boolean

boolean

null

null

null

null

422

Validation Error

object

detail

Array<object>

object

loc

required

Array

msg

required

string

type

required

string