Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.social-api.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

Publish posts to LinkedIn as the authenticated individual member (your personal feed). The connector supports text posts, single image, single video, and multi-image (carousel) posts.
Publishing as the individual member is live. Posting to Organization (company) Pages is coming soon, pending LinkedIn Community Management API approval.

​
Supported content

Content typeSupportedNotes
Text onlyYestext is the post commentary
Single imageYesone entry in media_ids
Single videoYesone video entry in media_ids
Multi-image (carousel)Yesmultiple image entries in media_ids
Mixed image + videoNoLinkedIn does not support mixed carousels
Article / linkYesprovide your own thumbnail, title, description

​
Post fields

LinkedIn uses the standard POST /v1/posts body. The target account is specified inside targets, not at the top level.
FieldTypeRequiredDescription
textstringYesPost commentary
targetsarrayYesOne entry per account; each requires account_id. The platform is inferred from the account, no platform field is sent
media_idsarrayNoIDs of media uploaded via the media upload flow; attach images or a video
LinkedIn member posts are always published with PUBLIC visibility. The post-level visibility field is accepted by the API but ignored for LinkedIn targets.

​
Creating a post

curl -X POST https://api.social-api.ai/v1/posts \
  -H "Authorization: Bearer $SOCIALAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "targets": [{ "account_id": "acc_01HZ9X3Q4R5M6N7P8V2K0W1J" }],
    "text": "Big news from our team!",
    "media_ids": ["f47ac10b-58cc-4372-a567-0e02b2c3d479"]
  }'
The post publishes to the member’s feed. The author is the authenticated person. To attach media, upload it first (see the Instagram media upload steps) and pass the returned media_id values in media_ids.

​
Updating a post

Only the post text (commentary) can be changed after publishing. Attached media cannot be modified. 
curl -X PATCH https://api.social-api.ai/v1/posts/{post_id} \
  -H "Authorization: Bearer $SOCIALAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text": "Updated announcement text"}'

​
Deleting a post

curl -X DELETE https://api.social-api.ai/v1/posts/{post_id} \
  -H "Authorization: Bearer $SOCIALAPI_KEY"

​
Reading posts

Reading a member’s own posts directly from LinkedIn requires elevated permissions and is not available. Listing posts returns the posts SocialAPI has stored for the account (for example, posts you published through SocialAPI), not a live read from LinkedIn.

​
Quirks and limitations

  • Posts are published as the individual member, not an organization page. Organization page posting is not available yet.
  • Only the commentary can be updated after publishing.
  • Mixed image and video carousels are not supported.
  • The post URN is returned in a response header during creation.
  • Reading a member’s own posts live from LinkedIn is not available; stored posts are returned instead.

​
Next steps

LinkedIn connector

Connection and authentication details.

Posts overview

How publishing works across all platforms.