Skip to main content
POST
Create a Social Selling draft

Authorizations

x-api-key
string
header
required

Body

application/json
identityId
integer
required

The identity that will publish it (an identity the caller may use).

text
string
required

Post text, up to 3000 characters. Mention slices must match their labels.

Maximum string length: 3000
title
string | null

Name in Enginy (never published). Defaults to the text’s first line when scheduled.

Maximum string length: 200
mentions
object[]
Maximum array length: 50
attachments
object[]

Ordered media by assetId: uploads (ssa_…, completed) or a tracked post’s media (spm_…, copied into the workspace when attached, keeping the source and credit). Up to 20 images, or one video, or one document; never mixed.

Maximum array length: 20
firstComment
string | null

Posted by the same person 30 seconds after the post goes live, on the published post (e.g. the link). null removes it.

Maximum string length: 1250
visibility
enum<string>

Who can see the post on LinkedIn. Default ANYONE.

Available options:
ANYONE,
CONNECTIONS
postAsCompany
boolean

Publish as a LinkedIn company page the identity administers (companyUrn required).

companyUrn
string | null

The company page’s numeric LinkedIn id.

Pattern: ^\d+$
sourceAttribution
string | null

Credit for a borrowed concept (kept with the draft and its media copies).

Maximum string length: 200
series
string | null

Content series (e.g. "City maps").

Maximum string length: 200
pillar
string | null

Content pillar (e.g. build in public, education, product, industry).

Maximum string length: 200
objective
string | null
Maximum string length: 200
audience
string | null
Maximum string length: 200
factualSources
string[] | null

Sources backing the facts in the post (URLs or references).

Maximum array length: 20
Required string length: 1 - 2000
notes
string | null
Maximum string length: 5000

Response

The draft (version 1)

status
enum<string>
required
Available options:
success
message
string
required
data
object
required