API Reference/Endpoints
Create a post
POST/api/linkedin/gateway/posts
Publishes a new post from a connected account, or reposts an existing one. Also works against a connected Instagram account.
Authentication
Send your personal API key as a bearer token. A missing, malformed or revoked key returns 401.
Body parameters
FieldTypeDescription
account_id *stringA connected account's id.
text *stringThe post body. Leave empty for an unattributed repost.
repoststringThe id of a LinkedIn post to repost instead of publishing new content.
mentionsarrayLinkedIn only. Entries of { name, profile_id, is_company } to turn a {{index}} placeholder in text into a real mention.
external_linkstringLinkedIn only. A URL to attach as a link-preview card.
include_job_postingstringLinkedIn only. A job posting id to attach as a preview card.
as_organizationstringLinkedIn only. Post on behalf of a company page this account manages.
locationstringInstagram only. A location tag; the closest match is used.
post_type"feed" | "story"Instagram only. Defaults to feed.
Response fields
FieldTypeDescription
object"PostCreated"Always this value.
post_idstring | nullThe new post's id, when the provider returns one immediately.
Attaching images or a video isn't reachable through this JSON route yet — the underlying call takes file uploads as multipart form data, which the gateway doesn't forward. Text-only posts, reposts and mentions all work as documented above.
Errors
·400 Bad Request. account_id or text is missing.·401 Unauthorized. The key is missing, malformed or has been rotated.·403 Forbidden. The account_id doesn't belong to this key, or this feature isn't on the connected account's plan.
