Skip to content
Docs

Typed Focus mode operations for LinkedIn accounts, generated from the LinkedIn focus module (same behaviour as the generic /accounts/{accountId}/focus routes).

Base URLhttps://api.socialit.com/v1AuthenticationErrorsRate limits64 endpointsMCP toolset focus_linkedin

Profile

LinkedIn: Get Profile

GET/accounts/{accountId}/linkedin/profile

Get the profile or Page details. The connected member profile or LinkedIn Page. LinkedIn does not expose Page editing in the versioned API; edit details on linkedin.com. Requires one of: r_basicprofile | profile | rw_organization_admin. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/organizations/organization-lookup-api Generic route: /v1/accounts/{accountId}/focus/profile.

Access: read

Try it with MCPAsk your agent to call linkedin-profile-get (toolset focus_linkedin)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

idstring
urnstring
account_typestring

organizationmember

namestring
vanity_namestring | null
headlinestring | null

Member headline

descriptionstring | null
websitestring (uri) | null
industriesarray of string
staff_count_rangestring | null
organization_typestring | null
primary_organization_typestring | null
founded_onobject | null
Show 3 child attributes
yearinteger
monthinteger
dayinteger
specialtiesarray of string
locationsarray of object
Show 5 item attributes
citystring
countrystring
line1string
postal_codestring
headquarterboolean
logo_urlstring (uri) | null
cover_photostring | null
followersinteger | null
connectionsinteger | null

First-degree connections (r_1st_connections_size)

profile_urlstring (uri)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/linkedin/profile
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/profile" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Organizations

LinkedIn: List Pages

GET/accounts/{accountId}/linkedin/organizations

List administered Pages. LinkedIn Pages the member holds a role on. Switch this connection between the personal profile and a Page. Cursor pagination: pass next_cursor back as cursor. Requires one of: rw_organization_admin | r_organization_admin. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/organizations/organization-access-control-by-role Generic route: /v1/accounts/{accountId}/focus/organizations.

Access: readZernio: GET /v1/accounts/{accountId}/linkedin-organizations

Try it with MCPAsk your agent to call linkedin-organizations-list (toolset focus_linkedin)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 9 item attributes
idstring
urnstring
namestring
localizedNamestring
vanityNamestring | null
logoUrlstring (uri) | null
rolesarray of string
canPostboolean
isAdminboolean
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/linkedin/organizations
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/organizations" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

LinkedIn: Get a Pages item

GET/accounts/{accountId}/linkedin/organizations/{itemId}

LinkedIn Pages the member holds a role on. Switch this connection between the personal profile and a Page. Requires one of: rw_organization_admin | r_organization_admin. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/organizations/organization-access-control-by-role Generic route: /v1/accounts/{accountId}/focus/organizations.

Access: read

Try it with MCPAsk your agent to call linkedin-organizations-get (toolset focus_linkedin)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstring
urnstring
namestring
localizedNamestring
vanityNamestring | null
logoUrlstring (uri) | null
rolesarray of string
canPostboolean
isAdminboolean

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/linkedin/organizations/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/organizations/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

LinkedIn: Use this Page (Pages)

POST/accounts/{accountId}/linkedin/organizations/{itemId}/switch-to-organization

Switch the connection to act as this Page. LinkedIn Pages the member holds a role on. Switch this connection between the personal profile and a Page. Requires scopes: w_organization_social. Requires one of: rw_organization_admin | r_organization_admin. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/organizations/organization-access-control-by-role Generic route: /v1/accounts/{accountId}/focus/organizations.

Access: writeIdempotency-KeyZernio: PUT /v1/accounts/{accountId}/linkedin-organization

Try it with MCPAsk your agent to call linkedin-organizations-switch-to-organization (toolset focus_linkedin)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/linkedin/organizations/{itemId}/switch-to-organization
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/organizations/ITEM_ID/switch-to-organization" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

LinkedIn: Use personal profile (Pages)

POST/accounts/{accountId}/linkedin/organizations/switch-to-personal

Use personal profile. LinkedIn Pages the member holds a role on. Switch this connection between the personal profile and a Page. Requires scopes: w_member_social. Requires one of: rw_organization_admin | r_organization_admin. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/organizations/organization-access-control-by-role Generic route: /v1/accounts/{accountId}/focus/organizations.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call linkedin-organizations-switch-to-personal (toolset focus_linkedin)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/linkedin/organizations/switch-to-personal
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/organizations/switch-to-personal" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Brands

LinkedIn: List Showcase pages

GET/accounts/{accountId}/linkedin/brands

Brand / showcase pages under the organization that the member administers. Cursor pagination: pass next_cursor back as cursor. Requires scopes: rw_organization_admin. Generic route: /v1/accounts/{accountId}/focus/brands.

Access: read

Try it with MCPAsk your agent to call linkedin-brands-list (toolset focus_linkedin)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 5 item attributes
idstring
urnstring
namestring
vanity_namestring | null
typestring | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/linkedin/brands
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/brands" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Admins

LinkedIn: List Page admins

GET/accounts/{accountId}/linkedin/admins

Members holding roles on the Page (organizationAcls). The API only lets a member request the DSC poster role for themselves; assign other roles on linkedin.com. Cursor pagination: pass next_cursor back as cursor. Requires scopes: rw_organization_admin. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/organizations/organization-access-control-by-role Generic route: /v1/accounts/{accountId}/focus/admins.

Access: read

Try it with MCPAsk your agent to call linkedin-admins-list (toolset focus_linkedin)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

rolestring

ADMINISTRATORCONTENT_ADMINISTRATORDIRECT_SPONSORED_CONTENT_POSTERRECRUITING_POSTERLEAD_CAPTURE_ADMINISTRATORLEAD_GEN_FORMS_MANAGERANALYSTCURATOR

statestring

APPROVEDREQUESTEDREJECTEDREVOKED

cursorstring

Opaque cursor (start offset) from next_cursor

limitintegerdefault: 25

1–100

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 5 item attributes
idstring
organizationstring
role_assigneestring

urn:li:person:…

rolestring

ADMINISTRATORCONTENT_ADMINISTRATORDIRECT_SPONSORED_CONTENT_POSTERRECRUITING_POSTERLEAD_CAPTURE_ADMINISTRATORLEAD_GEN_FORMS_MANAGERANALYSTCURATOR

statestring

APPROVEDREQUESTEDREJECTEDREVOKED

limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/linkedin/admins
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/admins" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

LinkedIn: Request DSC poster role (Page admins)

POST/accounts/{accountId}/linkedin/admins/request-dsc-role

Request DSC poster role. Members holding roles on the Page (organizationAcls). The API only lets a member request the DSC poster role for themselves; assign other roles on linkedin.com. Requires scopes: rw_organization_admin. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/organizations/organization-access-control-by-role Generic route: /v1/accounts/{accountId}/focus/admins.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call linkedin-admins-request-dsc-role (toolset focus_linkedin)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

organization_urnstring

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/linkedin/admins/request-dsc-role
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/admins/request-dsc-role" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "organization_urn": "string"
  }'
Response · 200

Posts

LinkedIn: List Posts

GET/accounts/{accountId}/linkedin/posts

List posts by author (newest first). Posts by this Page (r_organization_social). Listing a member's own posts needs the closed r_member_social permission; posts published through Socialit are tracked by Socialit. Cursor pagination: pass next_cursor back as cursor. Requires one of: r_organization_social | r_member_social. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/shares/posts-api Generic route: /v1/accounts/{accountId}/focus/posts.

Access: readZernio: GET /v1/accounts/{accountId}/posts

Try it with MCPAsk your agent to call linkedin-posts-list (toolset focus_linkedin)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

sort_bystring

LAST_MODIFIEDCREATED

view_contextstring

READERAUTHOR

cursorstring

Opaque cursor (start offset) from next_cursor

limitintegerdefault: 25

1–100

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 26 item attributes
idstring

urn:li:share:… or urn:li:ugcPost:…

urlstring (uri)
authorstring
textstring

≤ 3000 characters

commentarystring

Raw little-text commentary

typestring

textimagemulti_imagevideodocumentarticlepollreshareeventcelebrationcarousel

mentionsarray of object
Show 2 item attributes
namestring
urnstring
hashtagsarray of string
mediaarray of object
Show 3 item attributes
urnstring
titlestring | null
alt_textstring | null
articleobject | null
Show 4 child attributes
urlstring (uri)
titlestring
descriptionstring
thumbnailstring
pollobject | null
Show 4 child attributes
questionstring
durationstring
unique_votersinteger
optionsarray of object
Show 2 item attributes
textstring
vote_countinteger | null
eventstring | null
reshare_parentstring | null
reshare_rootstring | null
visibilitystring

PUBLICCONNECTIONSLOGGED_IN

feed_distributionstring

MAIN_FEEDNONE

targetedboolean
lifecycle_statestring

PUBLISHEDDRAFTPUBLISH_REQUESTEDPUBLISH_FAILED

is_reshare_disabledboolean
editedboolean
cta_labelstring | null

APPLYDOWNLOADVIEW_QUOTELEARN_MORESIGN_UPSUBSCRIBEREGISTERJOINATTENDREQUEST_DEMOSEE_MOREBUY_NOWSHOP_NOW

landing_pagestring (uri) | null
sponsoredboolean
created_atstring (date-time)
published_atstring (date-time) | null
updated_atstring (date-time) | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/linkedin/posts
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/posts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

LinkedIn: Create a Posts item

POST/accounts/{accountId}/linkedin/posts

Publish a post. Posts by this Page (r_organization_social). Listing a member's own posts needs the closed r_member_social permission; posts published through Socialit are tracked by Socialit. Requires one of: r_organization_social | r_member_social. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/shares/posts-api Generic route: /v1/accounts/{accountId}/focus/posts.

Access: writeIdempotency-KeyZernio: POST /v1/posts/{postId}/editPOST /v1/posts/{postId}/unpublishPOST /v1/posts/sync-external

Try it with MCPAsk your agent to call linkedin-posts-create (toolset focus_linkedin)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

textstring

≤ 3000 characters

media_idsarray of string
first_commentstring

≤ 1250 characters

optionsobject
Show 21 child attributes
organizationUrnstring

Publish as this organization (urn:li:organization:) instead of the account default. The member must be ADMINISTRATOR, CONTENT_ADMINISTRATOR or DSC poster.

visibilitystringdefault: "PUBLIC"

CONNECTIONS is member-only.

PUBLICCONNECTIONSLOGGED_IN

feedDistributionstringdefault: "MAIN_FEED"

NONE creates a dark post (organizations; used for ads).

MAIN_FEEDNONE

firstCommentstring

Posted as the author right after publishing.

≤ 1250 characters

disableLinkPreviewbooleandefault: false

When false, a text post containing a URL becomes an article share built from the page OpenGraph tags.

disableResharebooleandefault: false

isReshareDisabledByAuthor

disableCommentsbooleandefault: false

Close comments after publishing (needs *_social_feed).

hashtagsbooleandefault: true

Keep #hashtags clickable (otherwise escaped as text).

mentionsarray of object

Turn the first plain "@Name" into a mention. Inline @Name syntax also works.

Show 2 item attributes
namestringrequired
urnstringrequired

pattern ^urn:li:(person|organization|organizationBrand):

documentTitlestring

Title of a document post (required by LinkedIn; defaults to media title or filename).

videoTitlestring
thumbnailUrlstring (uri)

Custom video thumbnail (also media[].thumbnail).

waitForVideobooleandefault: true

Poll the video until AVAILABLE before creating the post.

videoProcessingTimeoutMsintegerdefault: 600000
reshareUrlstring

Post link or urn:li:share / ugcPost URN to repost. With text: repost with your thoughts. Mutually exclusive with media and polls.

articleobject
Show 6 child attributes
urlstring (uri)required
titlestring
descriptionstring
thumbnailUrlstring (uri)
thumbnailUrnstring

pattern ^urn:li:image:

thumbnailAltTextstring

≤ 4086 characters

pollobject
Show 3 child attributes
questionstringrequired

1–140 characters

optionsarray of stringrequired

2–4 items

durationstringdefault: "SEVEN_DAYS"

ONE_DAYTHREE_DAYSSEVEN_DAYSFOURTEEN_DAYS

eventUrnstring

Share a LinkedIn Event (content.reference).

pattern ^urn:li:(event|liveVideo):

callToActionobject
Show 2 child attributes
labelstring

APPLYDOWNLOADVIEW_QUOTELEARN_MORESIGN_UPSUBSCRIBEREGISTERJOINATTENDREQUEST_DEMOSEE_MOREBUY_NOWSHOP_NOW

landingPagestring (uri)
geoRestrictionobject

Organizations only; audience must exceed 300 members.

Show 1 child attributes
countriesarray of string

1–25 items

audienceobject

Targeted organic post (distribution.targetEntities). Organizations only; OR within a facet, AND across facets; >300 members.

Show 10 child attributes
countriesarray of string

≤ 25 items

geoLocationsarray of string
interfaceLocalesarray of object
Show 2 item attributes
languagestringrequired
countrystringrequired
industriesarray of string
jobFunctionsarray of string
senioritiesarray of string
staffCountRangesarray of string
degreesarray of string
fieldsOfStudyarray of string
organizationsarray of string

Returns object

idstring

urn:li:share:… or urn:li:ugcPost:…

urlstring (uri)
authorstring
textstring

≤ 3000 characters

commentarystring

Raw little-text commentary

typestring

textimagemulti_imagevideodocumentarticlepollreshareeventcelebrationcarousel

mentionsarray of object
Show 2 item attributes
namestring
urnstring
hashtagsarray of string
mediaarray of object
Show 3 item attributes
urnstring
titlestring | null
alt_textstring | null
articleobject | null
Show 4 child attributes
urlstring (uri)
titlestring
descriptionstring
thumbnailstring
pollobject | null
Show 4 child attributes
questionstring
durationstring
unique_votersinteger
optionsarray of object
Show 2 item attributes
textstring
vote_countinteger | null
eventstring | null
reshare_parentstring | null
reshare_rootstring | null
visibilitystring

PUBLICCONNECTIONSLOGGED_IN

feed_distributionstring

MAIN_FEEDNONE

targetedboolean
lifecycle_statestring

PUBLISHEDDRAFTPUBLISH_REQUESTEDPUBLISH_FAILED

is_reshare_disabledboolean
editedboolean
cta_labelstring | null

APPLYDOWNLOADVIEW_QUOTELEARN_MORESIGN_UPSUBSCRIBEREGISTERJOINATTENDREQUEST_DEMOSEE_MOREBUY_NOWSHOP_NOW

landing_pagestring (uri) | null
sponsoredboolean
created_atstring (date-time)
published_atstring (date-time) | null
updated_atstring (date-time) | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/linkedin/posts
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/posts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "string",
    "media_ids": [
      "string"
    ],
    "first_comment": "string",
    "options": {
      "organizationUrn": "string",
      "visibility": "PUBLIC"
    }
  }'
Response · 201

LinkedIn: Get a Posts item

GET/accounts/{accountId}/linkedin/posts/{itemId}

Posts by this Page (r_organization_social). Listing a member's own posts needs the closed r_member_social permission; posts published through Socialit are tracked by Socialit. Requires one of: r_organization_social | r_member_social. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/shares/posts-api Generic route: /v1/accounts/{accountId}/focus/posts.

Access: read

Try it with MCPAsk your agent to call linkedin-posts-get (toolset focus_linkedin)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstring

urn:li:share:… or urn:li:ugcPost:…

urlstring (uri)
authorstring
textstring

≤ 3000 characters

commentarystring

Raw little-text commentary

typestring

textimagemulti_imagevideodocumentarticlepollreshareeventcelebrationcarousel

mentionsarray of object
Show 2 item attributes
namestring
urnstring
hashtagsarray of string
mediaarray of object
Show 3 item attributes
urnstring
titlestring | null
alt_textstring | null
articleobject | null
Show 4 child attributes
urlstring (uri)
titlestring
descriptionstring
thumbnailstring
pollobject | null
Show 4 child attributes
questionstring
durationstring
unique_votersinteger
optionsarray of object
Show 2 item attributes
textstring
vote_countinteger | null
eventstring | null
reshare_parentstring | null
reshare_rootstring | null
visibilitystring

PUBLICCONNECTIONSLOGGED_IN

feed_distributionstring

MAIN_FEEDNONE

targetedboolean
lifecycle_statestring

PUBLISHEDDRAFTPUBLISH_REQUESTEDPUBLISH_FAILED

is_reshare_disabledboolean
editedboolean
cta_labelstring | null

APPLYDOWNLOADVIEW_QUOTELEARN_MORESIGN_UPSUBSCRIBEREGISTERJOINATTENDREQUEST_DEMOSEE_MOREBUY_NOWSHOP_NOW

landing_pagestring (uri) | null
sponsoredboolean
created_atstring (date-time)
published_atstring (date-time) | null
updated_atstring (date-time) | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/linkedin/posts/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/posts/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

LinkedIn: Update a Posts item

PATCH/accounts/{accountId}/linkedin/posts/{itemId}

Edit the text / CTA of a published post. Posts by this Page (r_organization_social). Listing a member's own posts needs the closed r_member_social permission; posts published through Socialit are tracked by Socialit. Requires one of: r_organization_social | r_member_social. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/shares/posts-api Generic route: /v1/accounts/{accountId}/focus/posts.

Access: write

Try it with MCPAsk your agent to call linkedin-posts-update (toolset focus_linkedin)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

textstring

≤ 3000 characters

cta_labelstring

APPLYDOWNLOADVIEW_QUOTELEARN_MORESIGN_UPSUBSCRIBEREGISTERJOINATTENDREQUEST_DEMOSEE_MOREBUY_NOWSHOP_NOW

landing_pagestring (uri)

Returns object

idstring

urn:li:share:… or urn:li:ugcPost:…

urlstring (uri)
authorstring
textstring

≤ 3000 characters

commentarystring

Raw little-text commentary

typestring

textimagemulti_imagevideodocumentarticlepollreshareeventcelebrationcarousel

mentionsarray of object
Show 2 item attributes
namestring
urnstring
hashtagsarray of string
mediaarray of object
Show 3 item attributes
urnstring
titlestring | null
alt_textstring | null
articleobject | null
Show 4 child attributes
urlstring (uri)
titlestring
descriptionstring
thumbnailstring
pollobject | null
Show 4 child attributes
questionstring
durationstring
unique_votersinteger
optionsarray of object
Show 2 item attributes
textstring
vote_countinteger | null
eventstring | null
reshare_parentstring | null
reshare_rootstring | null
visibilitystring

PUBLICCONNECTIONSLOGGED_IN

feed_distributionstring

MAIN_FEEDNONE

targetedboolean
lifecycle_statestring

PUBLISHEDDRAFTPUBLISH_REQUESTEDPUBLISH_FAILED

is_reshare_disabledboolean
editedboolean
cta_labelstring | null

APPLYDOWNLOADVIEW_QUOTELEARN_MORESIGN_UPSUBSCRIBEREGISTERJOINATTENDREQUEST_DEMOSEE_MOREBUY_NOWSHOP_NOW

landing_pagestring (uri) | null
sponsoredboolean
created_atstring (date-time)
published_atstring (date-time) | null
updated_atstring (date-time) | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/linkedin/posts/{itemId}
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/posts/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "string",
    "cta_label": "APPLY",
    "landing_page": "https://example.com"
  }'
Response · 200

LinkedIn: Delete a Posts item

DELETE/accounts/{accountId}/linkedin/posts/{itemId}

Posts by this Page (r_organization_social). Listing a member's own posts needs the closed r_member_social permission; posts published through Socialit are tracked by Socialit. Requires one of: r_organization_social | r_member_social. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/shares/posts-api Generic route: /v1/accounts/{accountId}/focus/posts.

Access: write

Try it with MCPAsk your agent to call linkedin-posts-delete (toolset focus_linkedin)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/linkedin/posts/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/posts/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

LinkedIn: Turn off comments (Posts)

POST/accounts/{accountId}/linkedin/posts/{itemId}/close-comments

Closing comments deletes the existing comments on the post. Posts by this Page (r_organization_social). Listing a member's own posts needs the closed r_member_social permission; posts published through Socialit are tracked by Socialit. Destructive. Requires one of: r_organization_social | r_member_social. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/shares/posts-api Generic route: /v1/accounts/{accountId}/focus/posts.

Access: write

Try it with MCPAsk your agent to call linkedin-posts-close-comments (toolset focus_linkedin)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/linkedin/posts/{itemId}/close-comments
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/posts/ITEM_ID/close-comments" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

LinkedIn: Turn on comments (Posts)

POST/accounts/{accountId}/linkedin/posts/{itemId}/open-comments

Turn on comments. Posts by this Page (r_organization_social). Listing a member's own posts needs the closed r_member_social permission; posts published through Socialit are tracked by Socialit. Requires one of: r_organization_social | r_member_social. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/shares/posts-api Generic route: /v1/accounts/{accountId}/focus/posts.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call linkedin-posts-open-comments (toolset focus_linkedin)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/linkedin/posts/{itemId}/open-comments
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/posts/ITEM_ID/open-comments" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

LinkedIn: Comment (Posts)

POST/accounts/{accountId}/linkedin/posts/{itemId}/comment

Comment. Posts by this Page (r_organization_social). Listing a member's own posts needs the closed r_member_social permission; posts published through Socialit are tracked by Socialit. Requires one of: r_organization_social | r_member_social. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/shares/posts-api Generic route: /v1/accounts/{accountId}/focus/posts.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call linkedin-posts-comment (toolset focus_linkedin)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

textstringrequired

≤ 1250 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/linkedin/posts/{itemId}/comment
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/posts/ITEM_ID/comment" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "string"
  }'
Response · 200

LinkedIn: React (Posts)

POST/accounts/{accountId}/linkedin/posts/{itemId}/react

React. Posts by this Page (r_organization_social). Listing a member's own posts needs the closed r_member_social permission; posts published through Socialit are tracked by Socialit. Requires one of: r_organization_social | r_member_social. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/shares/posts-api Generic route: /v1/accounts/{accountId}/focus/posts.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call linkedin-posts-react (toolset focus_linkedin)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

reaction_typestringdefault: "LIKE"

LIKEPRAISEEMPATHYINTERESTAPPRECIATIONENTERTAINMENT

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/linkedin/posts/{itemId}/react
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/posts/ITEM_ID/react" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "reaction_type": "LIKE"
  }'
Response · 200

LinkedIn: Repost with thoughts (Posts)

POST/accounts/{accountId}/linkedin/posts/{itemId}/reshare

Repost with thoughts. Posts by this Page (r_organization_social). Listing a member's own posts needs the closed r_member_social permission; posts published through Socialit are tracked by Socialit. Requires one of: r_organization_social | r_member_social. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/shares/posts-api Generic route: /v1/accounts/{accountId}/focus/posts.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call linkedin-posts-reshare (toolset focus_linkedin)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

textstring

≤ 3000 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/linkedin/posts/{itemId}/reshare
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/posts/ITEM_ID/reshare" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "string"
  }'
Response · 200

Images

LinkedIn: List Images

GET/accounts/{accountId}/linkedin/images

Images used in recent posts. JPG / PNG / GIF (< 36,152,320 px, GIF ≤ 250 frames). Cursor pagination: pass next_cursor back as cursor. Requires one of: w_organization_social | w_member_social. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/shares/images-api Generic route: /v1/accounts/{accountId}/focus/images.

Access: read

Try it with MCPAsk your agent to call linkedin-images-list (toolset focus_linkedin)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Opaque cursor (start offset) from next_cursor

limitintegerdefault: 25

1–100

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 12 item attributes
idstring

urn:li:image|video|document:…

ownerstring
statusstring

WAITING_UPLOADPROCESSINGAVAILABLEPROCESSING_FAILED

download_urlstring (uri) | null
download_url_expires_atstring (date-time) | null
duration_msinteger | null
aspect_ratiostring | null
thumbnailstring (uri) | null
captionsstring (uri) | null
titlestring | null
used_in_poststring | null
processing_failure_reasonstring | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/linkedin/images
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/images" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

LinkedIn: Create a Images item

POST/accounts/{accountId}/linkedin/images

Upload a image (returns its URN for use in posts). JPG / PNG / GIF (< 36,152,320 px, GIF ≤ 250 frames). Requires one of: w_organization_social | w_member_social. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/shares/images-api Generic route: /v1/accounts/{accountId}/focus/images.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call linkedin-images-create (toolset focus_linkedin)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

media_idstring
urlstring (uri)

Returns object

idstring

urn:li:image|video|document:…

ownerstring
statusstring

WAITING_UPLOADPROCESSINGAVAILABLEPROCESSING_FAILED

download_urlstring (uri) | null
download_url_expires_atstring (date-time) | null
duration_msinteger | null
aspect_ratiostring | null
thumbnailstring (uri) | null
captionsstring (uri) | null
titlestring | null
used_in_poststring | null
processing_failure_reasonstring | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/linkedin/images
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/images" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "media_id": "string",
    "url": "https://example.com"
  }'
Response · 201

LinkedIn: Get a Images item

GET/accounts/{accountId}/linkedin/images/{itemId}

JPG / PNG / GIF (< 36,152,320 px, GIF ≤ 250 frames). Requires one of: w_organization_social | w_member_social. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/shares/images-api Generic route: /v1/accounts/{accountId}/focus/images.

Access: read

Try it with MCPAsk your agent to call linkedin-images-get (toolset focus_linkedin)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstring

urn:li:image|video|document:…

ownerstring
statusstring

WAITING_UPLOADPROCESSINGAVAILABLEPROCESSING_FAILED

download_urlstring (uri) | null
download_url_expires_atstring (date-time) | null
duration_msinteger | null
aspect_ratiostring | null
thumbnailstring (uri) | null
captionsstring (uri) | null
titlestring | null
used_in_poststring | null
processing_failure_reasonstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/linkedin/images/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/images/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Videos

LinkedIn: List Videos

GET/accounts/{accountId}/linkedin/videos

Videos used in recent posts. MP4 up to 5 GB, 3 s – 30 min (10 min for members); one English SRT caption and a custom thumbnail. Cursor pagination: pass next_cursor back as cursor. Requires one of: w_organization_social | w_member_social. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/shares/videos-api Generic route: /v1/accounts/{accountId}/focus/videos.

Access: read

Try it with MCPAsk your agent to call linkedin-videos-list (toolset focus_linkedin)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Opaque cursor (start offset) from next_cursor

limitintegerdefault: 25

1–100

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 12 item attributes
idstring

urn:li:image|video|document:…

ownerstring
statusstring

WAITING_UPLOADPROCESSINGAVAILABLEPROCESSING_FAILED

download_urlstring (uri) | null
download_url_expires_atstring (date-time) | null
duration_msinteger | null
aspect_ratiostring | null
thumbnailstring (uri) | null
captionsstring (uri) | null
titlestring | null
used_in_poststring | null
processing_failure_reasonstring | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/linkedin/videos
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/videos" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

LinkedIn: Create a Videos item

POST/accounts/{accountId}/linkedin/videos

Upload a video (returns its URN for use in posts). MP4 up to 5 GB, 3 s – 30 min (10 min for members); one English SRT caption and a custom thumbnail. Requires one of: w_organization_social | w_member_social. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/shares/videos-api Generic route: /v1/accounts/{accountId}/focus/videos.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call linkedin-videos-create (toolset focus_linkedin)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

media_idstring
urlstring (uri)
titlestring
thumbnail_media_idstring
captions_media_idstring

English SRT file

Returns object

idstring

urn:li:image|video|document:…

ownerstring
statusstring

WAITING_UPLOADPROCESSINGAVAILABLEPROCESSING_FAILED

download_urlstring (uri) | null
download_url_expires_atstring (date-time) | null
duration_msinteger | null
aspect_ratiostring | null
thumbnailstring (uri) | null
captionsstring (uri) | null
titlestring | null
used_in_poststring | null
processing_failure_reasonstring | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/linkedin/videos
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/videos" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "media_id": "string",
    "url": "https://example.com",
    "title": "string",
    "thumbnail_media_id": "string",
    "captions_media_id": "string"
  }'
Response · 201

LinkedIn: Get a Videos item

GET/accounts/{accountId}/linkedin/videos/{itemId}

MP4 up to 5 GB, 3 s – 30 min (10 min for members); one English SRT caption and a custom thumbnail. Requires one of: w_organization_social | w_member_social. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/shares/videos-api Generic route: /v1/accounts/{accountId}/focus/videos.

Access: read

Try it with MCPAsk your agent to call linkedin-videos-get (toolset focus_linkedin)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstring

urn:li:image|video|document:…

ownerstring
statusstring

WAITING_UPLOADPROCESSINGAVAILABLEPROCESSING_FAILED

download_urlstring (uri) | null
download_url_expires_atstring (date-time) | null
duration_msinteger | null
aspect_ratiostring | null
thumbnailstring (uri) | null
captionsstring (uri) | null
titlestring | null
used_in_poststring | null
processing_failure_reasonstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/linkedin/videos/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/videos/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Documents

LinkedIn: List Documents

GET/accounts/{accountId}/linkedin/documents

Documents used in recent posts. PDF, PPT, PPTX, DOC, DOCX up to 100 MB / 300 pages (shown as a carousel). Cursor pagination: pass next_cursor back as cursor. Requires one of: w_organization_social | w_member_social. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/shares/documents-api Generic route: /v1/accounts/{accountId}/focus/documents.

Access: read

Try it with MCPAsk your agent to call linkedin-documents-list (toolset focus_linkedin)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Opaque cursor (start offset) from next_cursor

limitintegerdefault: 25

1–100

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 12 item attributes
idstring

urn:li:image|video|document:…

ownerstring
statusstring

WAITING_UPLOADPROCESSINGAVAILABLEPROCESSING_FAILED

download_urlstring (uri) | null
download_url_expires_atstring (date-time) | null
duration_msinteger | null
aspect_ratiostring | null
thumbnailstring (uri) | null
captionsstring (uri) | null
titlestring | null
used_in_poststring | null
processing_failure_reasonstring | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/linkedin/documents
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/documents" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

LinkedIn: Create a Documents item

POST/accounts/{accountId}/linkedin/documents

Upload a document (returns its URN for use in posts). PDF, PPT, PPTX, DOC, DOCX up to 100 MB / 300 pages (shown as a carousel). Requires one of: w_organization_social | w_member_social. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/shares/documents-api Generic route: /v1/accounts/{accountId}/focus/documents.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call linkedin-documents-create (toolset focus_linkedin)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

media_idstring
urlstring (uri)
titlestring

Returns object

idstring

urn:li:image|video|document:…

ownerstring
statusstring

WAITING_UPLOADPROCESSINGAVAILABLEPROCESSING_FAILED

download_urlstring (uri) | null
download_url_expires_atstring (date-time) | null
duration_msinteger | null
aspect_ratiostring | null
thumbnailstring (uri) | null
captionsstring (uri) | null
titlestring | null
used_in_poststring | null
processing_failure_reasonstring | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/linkedin/documents
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/documents" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "media_id": "string",
    "url": "https://example.com",
    "title": "string"
  }'
Response · 201

LinkedIn: Get a Documents item

GET/accounts/{accountId}/linkedin/documents/{itemId}

PDF, PPT, PPTX, DOC, DOCX up to 100 MB / 300 pages (shown as a carousel). Requires one of: w_organization_social | w_member_social. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/shares/documents-api Generic route: /v1/accounts/{accountId}/focus/documents.

Access: read

Try it with MCPAsk your agent to call linkedin-documents-get (toolset focus_linkedin)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstring

urn:li:image|video|document:…

ownerstring
statusstring

WAITING_UPLOADPROCESSINGAVAILABLEPROCESSING_FAILED

download_urlstring (uri) | null
download_url_expires_atstring (date-time) | null
duration_msinteger | null
aspect_ratiostring | null
thumbnailstring (uri) | null
captionsstring (uri) | null
titlestring | null
used_in_poststring | null
processing_failure_reasonstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/linkedin/documents/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/documents/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Events

LinkedIn: List Events

GET/accounts/{accountId}/linkedin/events

LinkedIn Events (Event Management API, separate product). Updates are only possible before the event starts. Cursor pagination: pass next_cursor back as cursor. Requires scopes: r_events. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/event-management/events Generic route: /v1/accounts/{accountId}/focus/events.

Access: read

Try it with MCPAsk your agent to call linkedin-events-list (toolset focus_linkedin)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

lifecyclestring

UPCOMINGONGOINGPAST

exclude_cancelledboolean
entry_criteriastring

PUBLICGATED

sort_orderstring

START_TIME_ASCEND_TIME_DESC

cursorstring

Opaque cursor (start offset) from next_cursor

limitintegerdefault: 25

1–100

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 18 item attributes
idstring
urnstring
namestring

≤ 255 characters

descriptionstring | null
typestring

live_videoexternalin_person

organizerstring
starts_atstring (date-time)
ends_atstring (date-time) | null
urlstring (uri) | null
addressobject | null
Show 5 child attributes
line1string
citystring
geographicAreastring
postalCodestring
countrystring
venue_detailsstring | null
vanity_namestring | null
discovery_modestring | null

LISTEDURL_ONLY

background_imagestring | null
live_videostring | null
ugc_poststring | null
created_atstring (date-time) | null
updated_atstring (date-time) | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/linkedin/events
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/events" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

LinkedIn: Create a Events item

POST/accounts/{accountId}/linkedin/events

LinkedIn Events (Event Management API, separate product). Updates are only possible before the event starts. Requires scopes: r_events, rw_events. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/event-management/events Generic route: /v1/accounts/{accountId}/focus/events.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call linkedin-events-create (toolset focus_linkedin)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

namestring
typestring

live_videoexternalin_person

starts_atstring (date-time)
ends_atstring (date-time)
descriptionstring
urlstring (uri)
addressobject
Show 5 child attributes
line1string
citystring
geographicAreastring
postalCodestring
countrystring
venue_detailsstring
vanity_namestring
discovery_modestring

LISTEDURL_ONLY

background_imagestring

urn:li:digitalmediaAsset:…

privacy_policy_urlstring (uri)

Attach a templated lead gen registration form

test_eventboolean
postbooleandefault: true

Share the event to the feed (required for it to be visible)

commentarystring

Returns object

idstring
urnstring
namestring

≤ 255 characters

descriptionstring | null
typestring

live_videoexternalin_person

organizerstring
starts_atstring (date-time)
ends_atstring (date-time) | null
urlstring (uri) | null
addressobject | null
Show 5 child attributes
line1string
citystring
geographicAreastring
postalCodestring
countrystring
venue_detailsstring | null
vanity_namestring | null
discovery_modestring | null

LISTEDURL_ONLY

background_imagestring | null
live_videostring | null
ugc_poststring | null
created_atstring (date-time) | null
updated_atstring (date-time) | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/linkedin/events
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/events" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string",
    "type": "live_video",
    "starts_at": "2026-10-13T09:00:00.000Z",
    "ends_at": "2026-10-13T09:00:00.000Z",
    "description": "string"
  }'
Response · 201

LinkedIn: Get a Events item

GET/accounts/{accountId}/linkedin/events/{itemId}

LinkedIn Events (Event Management API, separate product). Updates are only possible before the event starts. Requires scopes: r_events. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/event-management/events Generic route: /v1/accounts/{accountId}/focus/events.

Access: read

Try it with MCPAsk your agent to call linkedin-events-get (toolset focus_linkedin)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstring
urnstring
namestring

≤ 255 characters

descriptionstring | null
typestring

live_videoexternalin_person

organizerstring
starts_atstring (date-time)
ends_atstring (date-time) | null
urlstring (uri) | null
addressobject | null
Show 5 child attributes
line1string
citystring
geographicAreastring
postalCodestring
countrystring
venue_detailsstring | null
vanity_namestring | null
discovery_modestring | null

LISTEDURL_ONLY

background_imagestring | null
live_videostring | null
ugc_poststring | null
created_atstring (date-time) | null
updated_atstring (date-time) | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/linkedin/events/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/events/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

LinkedIn: Update a Events item

PATCH/accounts/{accountId}/linkedin/events/{itemId}

LinkedIn Events (Event Management API, separate product). Updates are only possible before the event starts. Requires scopes: r_events, rw_events. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/event-management/events Generic route: /v1/accounts/{accountId}/focus/events.

Access: write

Try it with MCPAsk your agent to call linkedin-events-update (toolset focus_linkedin)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

namestring
typestring

live_videoexternalin_person

starts_atstring (date-time)
ends_atstring (date-time)
descriptionstring
urlstring (uri)
addressobject
Show 5 child attributes
line1string
citystring
geographicAreastring
postalCodestring
countrystring
venue_detailsstring
vanity_namestring
discovery_modestring

LISTEDURL_ONLY

background_imagestring

urn:li:digitalmediaAsset:…

privacy_policy_urlstring (uri)

Attach a templated lead gen registration form

test_eventboolean
postbooleandefault: true

Share the event to the feed (required for it to be visible)

commentarystring

Returns object

idstring
urnstring
namestring

≤ 255 characters

descriptionstring | null
typestring

live_videoexternalin_person

organizerstring
starts_atstring (date-time)
ends_atstring (date-time) | null
urlstring (uri) | null
addressobject | null
Show 5 child attributes
line1string
citystring
geographicAreastring
postalCodestring
countrystring
venue_detailsstring | null
vanity_namestring | null
discovery_modestring | null

LISTEDURL_ONLY

background_imagestring | null
live_videostring | null
ugc_poststring | null
created_atstring (date-time) | null
updated_atstring (date-time) | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/linkedin/events/{itemId}
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/events/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string",
    "type": "live_video",
    "starts_at": "2026-10-13T09:00:00.000Z",
    "ends_at": "2026-10-13T09:00:00.000Z",
    "description": "string"
  }'
Response · 200

LinkedIn: Delete a Events item

DELETE/accounts/{accountId}/linkedin/events/{itemId}

LinkedIn Events (Event Management API, separate product). Updates are only possible before the event starts. Requires scopes: r_events, rw_events. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/event-management/events Generic route: /v1/accounts/{accountId}/focus/events.

Access: write

Try it with MCPAsk your agent to call linkedin-events-delete (toolset focus_linkedin)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/linkedin/events/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/events/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

LinkedIn: Share to feed (Events)

POST/accounts/{accountId}/linkedin/events/{itemId}/post

Share to feed. LinkedIn Events (Event Management API, separate product). Updates are only possible before the event starts. Requires scopes: r_events, rw_events, w_organization_social. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/event-management/events Generic route: /v1/accounts/{accountId}/focus/events.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call linkedin-events-post (toolset focus_linkedin)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

commentarystring
typestring

live_videoexternalin_person

live_videostring

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/linkedin/events/{itemId}/post
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/events/ITEM_ID/post" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "commentary": "string",
    "type": "live_video",
    "live_video": "string"
  }'
Response · 200

Comments

LinkedIn: List Comments

GET/accounts/{accountId}/linkedin/comments

Comments on a post, or replies to a comment. Comments and replies on posts. Page posts need r_organization_social_feed; comments on member posts need the restricted r_member_social_feed. LinkedIn has no comment hiding. Commenter data may be cached 24 h, activity 48 h. Cursor pagination: pass next_cursor back as cursor. Requires one of: r_organization_social_feed | r_member_social_feed. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/shares/comments-api Generic route: /v1/accounts/{accountId}/focus/comments.

Access: readZernio: GET /v1/inbox/comments

Try it with MCPAsk your agent to call linkedin-comments-list (toolset focus_linkedin)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

post_idstring

Post URN (share / ugcPost / activity)

comment_idstring

List replies of this comment URN instead

cursorstring

Opaque cursor (start offset) from next_cursor

limitintegerdefault: 25

1–100

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 17 item attributes
idstring

Composite URN urn:li:comment:(thread,id)

textstring

≤ 1250 characters

authorstring

Actor URN (person or organization)

author_typestring

personorganization

agentstring | null

Member who commented on behalf of the Page

created_atstring (date-time)
updated_atstring (date-time) | null
editedboolean
like_countinteger
liked_by_meboolean
reply_countinteger
comment_idstring
post_idstring
parent_idstring | null
is_ownboolean
attachmentsarray of object
Show 3 item attributes
typestring
urnstring | null
urlstring (uri) | null
mentionsarray of object
Show 3 item attributes
startinteger
lengthinteger
urnstring
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/linkedin/comments
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/comments" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

LinkedIn: Create a Comments item

POST/accounts/{accountId}/linkedin/comments

Comment on a post or reply to a comment. Comments and replies on posts. Page posts need r_organization_social_feed; comments on member posts need the restricted r_member_social_feed. LinkedIn has no comment hiding. Commenter data may be cached 24 h, activity 48 h. Requires one of: r_organization_social_feed | r_member_social_feed. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/shares/comments-api Generic route: /v1/accounts/{accountId}/focus/comments.

Access: writeIdempotency-KeyZernio: POST /v1/inbox/comments/{postId}POST /v1/inbox/comments/{postId}/{commentId}/like

Try it with MCPAsk your agent to call linkedin-comments-create (toolset focus_linkedin)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

post_idstring
parent_comment_idstring

Reply to this comment URN

textstringrequired

≤ 1250 characters

image_media_idstring
mentionsarray of object
Show 3 item attributes
startinteger
lengthinteger
urnstring

Returns object

idstring

Composite URN urn:li:comment:(thread,id)

textstring

≤ 1250 characters

authorstring

Actor URN (person or organization)

author_typestring

personorganization

agentstring | null

Member who commented on behalf of the Page

created_atstring (date-time)
updated_atstring (date-time) | null
editedboolean
like_countinteger
liked_by_meboolean
reply_countinteger
comment_idstring
post_idstring
parent_idstring | null
is_ownboolean
attachmentsarray of object
Show 3 item attributes
typestring
urnstring | null
urlstring (uri) | null
mentionsarray of object
Show 3 item attributes
startinteger
lengthinteger
urnstring

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/linkedin/comments
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/comments" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "post_id": "string",
    "parent_comment_id": "string",
    "text": "string",
    "image_media_id": "string",
    "mentions": [
      {
        "start": 1,
        "length": 1
      }
    ]
  }'
Response · 201

LinkedIn: Get a Comments item

GET/accounts/{accountId}/linkedin/comments/{itemId}

Comments and replies on posts. Page posts need r_organization_social_feed; comments on member posts need the restricted r_member_social_feed. LinkedIn has no comment hiding. Commenter data may be cached 24 h, activity 48 h. Requires one of: r_organization_social_feed | r_member_social_feed. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/shares/comments-api Generic route: /v1/accounts/{accountId}/focus/comments.

Access: readZernio: GET /v1/inbox/comments/{postId}

Try it with MCPAsk your agent to call linkedin-comments-get (toolset focus_linkedin)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstring

Composite URN urn:li:comment:(thread,id)

textstring

≤ 1250 characters

authorstring

Actor URN (person or organization)

author_typestring

personorganization

agentstring | null

Member who commented on behalf of the Page

created_atstring (date-time)
updated_atstring (date-time) | null
editedboolean
like_countinteger
liked_by_meboolean
reply_countinteger
comment_idstring
post_idstring
parent_idstring | null
is_ownboolean
attachmentsarray of object
Show 3 item attributes
typestring
urnstring | null
urlstring (uri) | null
mentionsarray of object
Show 3 item attributes
startinteger
lengthinteger
urnstring

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/linkedin/comments/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/comments/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

LinkedIn: Update a Comments item

PATCH/accounts/{accountId}/linkedin/comments/{itemId}

Edit a comment written by this account. Comments and replies on posts. Page posts need r_organization_social_feed; comments on member posts need the restricted r_member_social_feed. LinkedIn has no comment hiding. Commenter data may be cached 24 h, activity 48 h. Requires one of: r_organization_social_feed | r_member_social_feed. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/shares/comments-api Generic route: /v1/accounts/{accountId}/focus/comments.

Access: writeZernio: PATCH /v1/inbox/comments/{postId}/{commentId}

Try it with MCPAsk your agent to call linkedin-comments-update (toolset focus_linkedin)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

textstringrequired

≤ 1250 characters

Returns object

idstring

Composite URN urn:li:comment:(thread,id)

textstring

≤ 1250 characters

authorstring

Actor URN (person or organization)

author_typestring

personorganization

agentstring | null

Member who commented on behalf of the Page

created_atstring (date-time)
updated_atstring (date-time) | null
editedboolean
like_countinteger
liked_by_meboolean
reply_countinteger
comment_idstring
post_idstring
parent_idstring | null
is_ownboolean
attachmentsarray of object
Show 3 item attributes
typestring
urnstring | null
urlstring (uri) | null
mentionsarray of object
Show 3 item attributes
startinteger
lengthinteger
urnstring

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/linkedin/comments/{itemId}
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/comments/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "string"
  }'
Response · 200

LinkedIn: Delete a Comments item

DELETE/accounts/{accountId}/linkedin/comments/{itemId}

Delete a comment (Pages can delete comments on their posts). Comments and replies on posts. Page posts need r_organization_social_feed; comments on member posts need the restricted r_member_social_feed. LinkedIn has no comment hiding. Commenter data may be cached 24 h, activity 48 h. Requires one of: r_organization_social_feed | r_member_social_feed. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/shares/comments-api Generic route: /v1/accounts/{accountId}/focus/comments.

Access: writeZernio: DELETE /v1/inbox/comments/{postId}DELETE /v1/inbox/comments/{postId}/{commentId}/like

Try it with MCPAsk your agent to call linkedin-comments-delete (toolset focus_linkedin)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/linkedin/comments/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/comments/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

LinkedIn: React (Comments)

POST/accounts/{accountId}/linkedin/comments/{itemId}/like

React. Comments and replies on posts. Page posts need r_organization_social_feed; comments on member posts need the restricted r_member_social_feed. LinkedIn has no comment hiding. Commenter data may be cached 24 h, activity 48 h. Requires one of: r_organization_social_feed | r_member_social_feed. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/shares/comments-api Generic route: /v1/accounts/{accountId}/focus/comments.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call linkedin-comments-like (toolset focus_linkedin)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

reaction_typestringdefault: "LIKE"

LIKEPRAISEEMPATHYINTERESTAPPRECIATIONENTERTAINMENT

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/linkedin/comments/{itemId}/like
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/comments/ITEM_ID/like" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "reaction_type": "LIKE"
  }'
Response · 200

LinkedIn: Remove reaction (Comments)

POST/accounts/{accountId}/linkedin/comments/{itemId}/unlike

Remove reaction. Comments and replies on posts. Page posts need r_organization_social_feed; comments on member posts need the restricted r_member_social_feed. LinkedIn has no comment hiding. Commenter data may be cached 24 h, activity 48 h. Requires one of: r_organization_social_feed | r_member_social_feed. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/shares/comments-api Generic route: /v1/accounts/{accountId}/focus/comments.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call linkedin-comments-unlike (toolset focus_linkedin)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/linkedin/comments/{itemId}/unlike
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/comments/ITEM_ID/unlike" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

LinkedIn: Reply (Comments)

POST/accounts/{accountId}/linkedin/comments/{itemId}/reply

Reply. Comments and replies on posts. Page posts need r_organization_social_feed; comments on member posts need the restricted r_member_social_feed. LinkedIn has no comment hiding. Commenter data may be cached 24 h, activity 48 h. Requires one of: r_organization_social_feed | r_member_social_feed. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/shares/comments-api Generic route: /v1/accounts/{accountId}/focus/comments.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call linkedin-comments-reply (toolset focus_linkedin)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

textstringrequired

≤ 1250 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/linkedin/comments/{itemId}/reply
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/comments/ITEM_ID/reply" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "string"
  }'
Response · 200

Reactions

LinkedIn: List Reactions

GET/accounts/{accountId}/linkedin/reactions

Individual reactions on a post or comment, plus the reaction breakdown (social metadata). Cursor pagination: pass next_cursor back as cursor. Requires one of: r_organization_social_feed | r_member_social_feed. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/shares/reactions-api Generic route: /v1/accounts/{accountId}/focus/reactions.

Access: readZernio: GET /v1/accounts/{accountId}/linkedin-post-reactions

Try it with MCPAsk your agent to call linkedin-reactions-list (toolset focus_linkedin)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

entitystringrequired

Post or comment URN

sortstring

REVERSE_CHRONOLOGICALCHRONOLOGICALRELEVANCE

cursorstring

Opaque cursor (start offset) from next_cursor

limitintegerdefault: 25

1–100

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 6 item attributes
idstring
reaction_typestring

LIKEPRAISEEMPATHYINTERESTAPPRECIATIONENTERTAINMENT

actorstring
actor_typestring

personorganization

rootstring
created_atstring (date-time)
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/linkedin/reactions
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/reactions?entity=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

LinkedIn: Create a Reactions item

POST/accounts/{accountId}/linkedin/reactions

React as this account. Individual reactions on a post or comment, plus the reaction breakdown (social metadata). Requires one of: r_organization_social_feed | r_member_social_feed. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/shares/reactions-api Generic route: /v1/accounts/{accountId}/focus/reactions.

Access: writeIdempotency-KeyZernio: POST /v1/inbox/posts/{postId}/like

Try it with MCPAsk your agent to call linkedin-reactions-create (toolset focus_linkedin)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

entitystringrequired
reaction_typestringdefault: "LIKE"

LIKEPRAISEEMPATHYINTERESTAPPRECIATIONENTERTAINMENT

Returns object

idstring
reaction_typestring

LIKEPRAISEEMPATHYINTERESTAPPRECIATIONENTERTAINMENT

actorstring
actor_typestring

personorganization

rootstring
created_atstring (date-time)

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/linkedin/reactions
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/reactions" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "entity": "string",
    "reaction_type": "LIKE"
  }'
Response · 201

LinkedIn: Delete a Reactions item

DELETE/accounts/{accountId}/linkedin/reactions/{itemId}

Remove this account's reaction (id = entity URN). Individual reactions on a post or comment, plus the reaction breakdown (social metadata). Requires one of: r_organization_social_feed | r_member_social_feed. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/shares/reactions-api Generic route: /v1/accounts/{accountId}/focus/reactions.

Access: writeZernio: DELETE /v1/inbox/posts/{postId}/like

Try it with MCPAsk your agent to call linkedin-reactions-delete (toolset focus_linkedin)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/linkedin/reactions/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/reactions/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

LinkedIn: Reaction breakdown (Reactions)

POST/accounts/{accountId}/linkedin/reactions/summary

Reaction breakdown. Individual reactions on a post or comment, plus the reaction breakdown (social metadata). Requires one of: r_organization_social_feed | r_member_social_feed. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/shares/reactions-api Generic route: /v1/accounts/{accountId}/focus/reactions.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call linkedin-reactions-summary (toolset focus_linkedin)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

entitystringrequired

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/linkedin/reactions/summary
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/reactions/summary" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "entity": "string"
  }'
Response · 200

Mentions

LinkedIn: List Mentions

GET/accounts/{accountId}/linkedin/mentions

Posts and comments that @mention the Page (Page notifications, retained 60 days; real-time via webhooks on CM Standard). Cursor pagination: pass next_cursor back as cursor. Requires scopes: rw_organization_admin. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/organizations/organization-social-action-notifications Generic route: /v1/accounts/{accountId}/focus/mentions.

Access: readZernio: GET /v1/inbox/mentions

Try it with MCPAsk your agent to call linkedin-mentions-list (toolset focus_linkedin)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

sincestring (date-time)
untilstring (date-time)
cursorstring

Opaque cursor (start offset) from next_cursor

limitintegerdefault: 25

1–100

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 10 item attributes
idstring
typestring

mention

kindstring

postcomment

post_idstring
comment_idstring | null
authorstring | null
textstring | null
organizationstring
created_atstring (date-time)
urlstring (uri)
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/linkedin/mentions
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/mentions" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

LinkedIn: Reply as Page (Mentions)

POST/accounts/{accountId}/linkedin/mentions/{itemId}/reply

Reply as Page. Posts and comments that @mention the Page (Page notifications, retained 60 days; real-time via webhooks on CM Standard). Requires scopes: rw_organization_admin, w_organization_social_feed. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/organizations/organization-social-action-notifications Generic route: /v1/accounts/{accountId}/focus/mentions.

Access: writeIdempotency-KeyZernio: POST /v1/inbox/mentions/reply

Try it with MCPAsk your agent to call linkedin-mentions-reply (toolset focus_linkedin)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

post_idstring
comment_idstring
messagestringrequired

≤ 1250 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/linkedin/mentions/{itemId}/reply
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/mentions/ITEM_ID/reply" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "post_id": "string",
    "comment_id": "string",
    "message": "string"
  }'
Response · 200

Notifications

LinkedIn: List Page activity

GET/accounts/{accountId}/linkedin/notifications

Likes, comments, reshares, mentions and comment edits/deletes on the Page (60-day retention). Cursor pagination: pass next_cursor back as cursor. Requires scopes: rw_organization_admin. Generic route: /v1/accounts/{accountId}/focus/notifications.

Access: read

Try it with MCPAsk your agent to call linkedin-notifications-list (toolset focus_linkedin)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

actionsarray of string
source_poststring
sincestring (date-time)
untilstring (date-time)
cursorstring

Opaque cursor (start offset) from next_cursor

limitintegerdefault: 25

1–100

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 10 item attributes
idstring
actionstring

LIKECOMMENTSHARESHARE_MENTIONADMIN_COMMENTCOMMENT_EDITCOMMENT_DELETE

kindstring

postcomment

organizationstring
source_poststring | null
generated_activitystring | null
authorstring | null
textstring | null
created_atstring (date-time)
urlstring (uri) | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/linkedin/notifications
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/notifications" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

LinkedIn: List Mention picker

GET/accounts/{accountId}/linkedin/mention-search

Find Page followers to @mention (People Typeahead, restricted r_organization_followers) and resolve profile / company URLs into mention URNs. Cursor pagination: pass next_cursor back as cursor. Requires scopes: r_organization_followers. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/shares/posts-atmention-search-api Generic route: /v1/accounts/{accountId}/focus/mention-search.

Access: readZernio: GET /v1/accounts/{accountId}/linkedin-mentions

Try it with MCPAsk your agent to call linkedin-mention-search-list (toolset focus_linkedin)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

keywordsstringrequired

≥ 3 characters

organization_urnstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 7 item attributes
urnstring
namestring
first_namestring
last_namestring
headlinestring | null
photo_urnstring | null
mention_formatstring
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/linkedin/mention-search
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/mention-search?keywords=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

LinkedIn: Resolve URL (Mention picker)

POST/accounts/{accountId}/linkedin/mention-search/resolve

Resolve a linkedin.com/in/… or /company/… URL into a mention. Find Page followers to @mention (People Typeahead, restricted r_organization_followers) and resolve profile / company URLs into mention URNs. Requires scopes: r_organization_followers. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/shares/posts-atmention-search-api Generic route: /v1/accounts/{accountId}/focus/mention-search.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call linkedin-mention-search-resolve (toolset focus_linkedin)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

urlstringrequired
display_namestring
organization_urnstring

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/linkedin/mention-search/resolve
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/mention-search/resolve" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com",
    "display_name": "string",
    "organization_urn": "string"
  }'
Response · 200

Insights

LinkedIn: Get Overview

GET/accounts/{accountId}/linkedin/insights

Daily impressions, reach, clicks, reactions, comments, reshares, followers and page views (Pages) or post performance and follower growth (members). Requires one of: rw_organization_admin | r_member_postAnalytics. Generic route: /v1/accounts/{accountId}/focus/insights.

Access: read

Try it with MCPAsk your agent to call linkedin-insights-get (toolset focus_linkedin)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

sincestring (date)

Inclusive start date (YYYY-MM-DD)

untilstring (date)

Inclusive end date (YYYY-MM-DD)

Returns object

seriesarray of object
Show 1 item attributes
datestring (date)
totalsobject

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/linkedin/insights
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/insights" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Followers

LinkedIn: Get Followers

GET/accounts/{accountId}/linkedin/followers

Follower count and daily organic / paid gains (12 months back to 2 days ago) for Pages; follower count and daily series for members. Requires one of: rw_organization_admin | r_member_profileAnalytics. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/organizations/follower-statistics Generic route: /v1/accounts/{accountId}/focus/followers.

Access: read

Try it with MCPAsk your agent to call linkedin-followers-get (toolset focus_linkedin)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

sincestring (date)

Inclusive start date (YYYY-MM-DD)

untilstring (date)

Inclusive end date (YYYY-MM-DD)

granularitystringdefault: "DAY"

DAYWEEKMONTH

Returns object

totalinteger
granularitystring

DAYWEEKMONTH

seriesarray of object
Show 5 item attributes
datestring (date)
organicinteger
paidinteger
totalinteger
valueinteger

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/linkedin/followers
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/followers" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Demographics

LinkedIn: Get Follower demographics

GET/accounts/{accountId}/linkedin/demographics

Lifetime follower breakdown by country, region, seniority, industry, job function, company size and association (top 100 per facet). Requires scopes: rw_organization_admin. Generic route: /v1/accounts/{accountId}/focus/demographics.

Access: read

Try it with MCPAsk your agent to call linkedin-demographics-get (toolset focus_linkedin)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

countriesarray of object
Show 2 item attributes
keystring
valueinteger
regionsarray of object
Show 2 item attributes
keystring
valueinteger
senioritiesarray of object
Show 2 item attributes
keystring
valueinteger
industriesarray of object
Show 2 item attributes
keystring
valueinteger
functionsarray of object
Show 2 item attributes
keystring
valueinteger
company_sizesarray of object
Show 2 item attributes
keystring
valueinteger
association_typesarray of object
Show 2 item attributes
keystring
valueinteger

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/linkedin/demographics
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/demographics" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Page statistics

LinkedIn: Get Page views

GET/accounts/{accountId}/linkedin/page-statistics

Page views by section (overview, life, jobs, careers) and device; lifetime breakdown by visitor demographics, or a daily / monthly series when a date range is given. Requires scopes: rw_organization_admin. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/organizations/page-statistics Generic route: /v1/accounts/{accountId}/focus/page-statistics.

Access: read

Try it with MCPAsk your agent to call linkedin-page-statistics-get (toolset focus_linkedin)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

sincestring (date)

Inclusive start date (YYYY-MM-DD)

untilstring (date)

Inclusive end date (YYYY-MM-DD)

granularitystring

DAYMONTH

brandstring

urn:li:organizationBrand:… (showcase page)

Returns object

totalsobject
seriesarray of object
Show 1 item attributes
datestring (date)
countriesarray of object
Show 2 item attributes
keystring
valueinteger
regionsarray of object
Show 2 item attributes
keystring
valueinteger
senioritiesarray of object
Show 2 item attributes
keystring
valueinteger
industriesarray of object
Show 2 item attributes
keystring
valueinteger
functionsarray of object
Show 2 item attributes
keystring
valueinteger
company_sizesarray of object
Show 2 item attributes
keystring
valueinteger

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/linkedin/page-statistics
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/page-statistics" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Share statistics

LinkedIn: Get Post performance

GET/accounts/{accountId}/linkedin/share-statistics

Organic impressions, unique impressions, clicks, reactions, comments, reshares and engagement rate (rolling 12 months). Requires scopes: rw_organization_admin. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/organizations/share-statistics Generic route: /v1/accounts/{accountId}/focus/share-statistics.

Access: read

Try it with MCPAsk your agent to call linkedin-share-statistics-get (toolset focus_linkedin)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

sincestring (date)

Inclusive start date (YYYY-MM-DD)

untilstring (date)

Inclusive end date (YYYY-MM-DD)

granularitystring

DAYMONTH

Returns object

lifetimeobject
seriesarray of object
Show 1 item attributes
datestring (date)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/linkedin/share-statistics
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/share-statistics" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Post analytics

LinkedIn: Get a Post analytics item

GET/accounts/{accountId}/linkedin/post-analytics/{itemId}

Lifetime metrics per post: impressions, reach, reactions, comments, reshares, clicks (Pages) or saves / sends (members); video views. Requires one of: rw_organization_admin | r_member_postAnalytics. Generic route: /v1/accounts/{accountId}/focus/post-analytics.

Access: read

Try it with MCPAsk your agent to call linkedin-post-analytics-get (toolset focus_linkedin)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

external_idstring
impressionsinteger
reachinteger
likesinteger
commentsinteger
sharesinteger
clicksinteger
savesinteger
viewsinteger
engagementsinteger
engagement_ratenumber

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/linkedin/post-analytics/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/post-analytics/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Video analytics

LinkedIn: Get Video analytics

GET/accounts/{accountId}/linkedin/video-analytics

Views, unique viewers and watch time of a video post (Pages: 6 months of data; members: plays, viewers, watch time). Requires one of: r_organization_social | r_member_postAnalytics. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/shares/video-analytics-api Generic route: /v1/accounts/{accountId}/focus/video-analytics.

Access: read

Try it with MCPAsk your agent to call linkedin-video-analytics-get (toolset focus_linkedin)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

post_idstringrequired
sincestring (date)

Inclusive start date (YYYY-MM-DD)

untilstring (date)

Inclusive end date (YYYY-MM-DD)

aggregationstring

ALLDAYWEEK

Returns object

post_idstring
rowsarray of object
Show 3 item attributes
typestring
datestring | null
valuenumber

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/linkedin/video-analytics
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/video-analytics?post_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Member post analytics

LinkedIn: Get Creator analytics

GET/accounts/{accountId}/linkedin/member-post-analytics

Member post analytics for one post or all posts: impressions, members reached, reactions, comments, reshares, saves, sends, link clicks, followers and profile views from content. Requires scopes: r_member_postAnalytics. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/members/post-statistics Generic route: /v1/accounts/{accountId}/focus/member-post-analytics.

Access: read

Try it with MCPAsk your agent to call linkedin-member-post-analytics-get (toolset focus_linkedin)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

post_idstring
metricsarray of string
aggregationstringdefault: "TOTAL"

TOTALDAILY

sincestring (date)

Inclusive start date (YYYY-MM-DD)

untilstring (date)

Inclusive end date (YYYY-MM-DD)

Returns object

rowsarray of object
Show 3 item attributes
metricstring

IMPRESSIONMEMBERS_REACHEDRESHAREREACTIONCOMMENTPOST_SAVEPOST_SENDLINK_CLICKSPREMIUM_CTA_CLICKSFOLLOWER_GAINED_FROM_CONTENTPROFILE_VIEW_FROM_CONTENT

datestring | null
valuenumber

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/linkedin/member-post-analytics
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/member-post-analytics" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Org aggregate

LinkedIn: Get Page analytics (aggregate)

GET/accounts/{accountId}/linkedin/org-aggregate

Zernio-compatible organization aggregate analytics (max 89 days). Requires scopes: rw_organization_admin. Generic route: /v1/accounts/{accountId}/focus/org-aggregate.

Access: readZernio: GET /v1/analytics/linkedin/org-aggregate-analytics

Try it with MCPAsk your agent to call linkedin-org-aggregate-get (toolset focus_linkedin)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

metricsarray of string
metric_typestring

time_seriestotal_value

sincestring (date)

Inclusive start date (YYYY-MM-DD)

untilstring (date)

Inclusive end date (YYYY-MM-DD)

Returns object

dateRangeobject
Show 2 child attributes
sincestring
untilstring
metricTypestring

time_seriestotal_value

metricsobject
unavailableMetricsarray of string

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/linkedin/org-aggregate
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/org-aggregate" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Member aggregate

LinkedIn: Get Profile analytics (aggregate)

GET/accounts/{accountId}/linkedin/member-aggregate

Zernio-compatible aggregated analytics across the member's posts. Requires scopes: r_member_postAnalytics. Generic route: /v1/accounts/{accountId}/focus/member-aggregate.

Access: readZernio: GET /v1/accounts/{accountId}/linkedin-aggregate-analytics

Try it with MCPAsk your agent to call linkedin-member-aggregate-get (toolset focus_linkedin)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

aggregationstring

TOTALDAILY

metricsarray of string
sincestring (date)

Inclusive start date (YYYY-MM-DD)

untilstring (date)

Inclusive end date (YYYY-MM-DD)

Returns object

aggregationstring

TOTALDAILY

analyticsobject
skippedMetricsarray of string

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/linkedin/member-aggregate
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/member-aggregate" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Webhook subscriptions

LinkedIn: List Real-time notifications

GET/accounts/{accountId}/linkedin/webhook-subscriptions

Webhook subscriptions for Page comments, mentions, reactions and reshares (Community Management Standard tier only; subscriptions end when the member's grant expires or their admin role is removed). Cursor pagination: pass next_cursor back as cursor. Requires scopes: rw_organization_admin. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/organizations/organization-social-action-notifications Generic route: /v1/accounts/{accountId}/focus/webhook-subscriptions.

Access: read

Try it with MCPAsk your agent to call linkedin-webhook-subscriptions-list (toolset focus_linkedin)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 6 item attributes
idstring
organizationstring
userstring
event_typestring

ORGANIZATION_SOCIAL_ACTION_NOTIFICATIONS

webhookstring (uri)
expires_atstring (date-time) | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/linkedin/webhook-subscriptions
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/webhook-subscriptions" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

LinkedIn: Create a Real-time notifications item

POST/accounts/{accountId}/linkedin/webhook-subscriptions

Subscribe the Page to webhook notifications. Webhook subscriptions for Page comments, mentions, reactions and reshares (Community Management Standard tier only; subscriptions end when the member's grant expires or their admin role is removed). Requires scopes: rw_organization_admin. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/organizations/organization-social-action-notifications Generic route: /v1/accounts/{accountId}/focus/webhook-subscriptions.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call linkedin-webhook-subscriptions-create (toolset focus_linkedin)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

webhook_urlstring (uri)required
organization_urnstring
developer_app_idstring

Defaults to LINKEDIN_ORG_APP_ID

Returns object

idstring
organizationstring
userstring
event_typestring

ORGANIZATION_SOCIAL_ACTION_NOTIFICATIONS

webhookstring (uri)
expires_atstring (date-time) | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/linkedin/webhook-subscriptions
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/webhook-subscriptions" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "webhook_url": "https://example.com",
    "organization_urn": "string",
    "developer_app_id": "string"
  }'
Response · 201

LinkedIn: Delete a Real-time notifications item

DELETE/accounts/{accountId}/linkedin/webhook-subscriptions/{itemId}

Unsubscribe (id = organization URN or "organization|user"). Webhook subscriptions for Page comments, mentions, reactions and reshares (Community Management Standard tier only; subscriptions end when the member's grant expires or their admin role is removed). Requires scopes: rw_organization_admin. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/organizations/organization-social-action-notifications Generic route: /v1/accounts/{accountId}/focus/webhook-subscriptions.

Access: write

Try it with MCPAsk your agent to call linkedin-webhook-subscriptions-delete (toolset focus_linkedin)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/linkedin/webhook-subscriptions/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/webhook-subscriptions/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Targeting

LinkedIn: Estimate audience (Audience targeting)

POST/accounts/{accountId}/linkedin/targeting/estimate-audience

Estimate audience. Estimate the audience of a targeted organic Page post (must exceed 300 members). Use the same facets as platform_options.linkedin.audience. Requires scopes: w_organization_social. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/shares/posts-api#create-targeted-organic-posts Generic route: /v1/accounts/{accountId}/focus/targeting.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call linkedin-targeting-estimate-audience (toolset focus_linkedin)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

countriesarray of string
geoLocationsarray of string
industriesarray of string
jobFunctionsarray of string
senioritiesarray of string
staffCountRangesarray of string
degreesarray of string
fieldsOfStudyarray of string
organizationsarray of string

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/linkedin/targeting/estimate-audience
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/targeting/estimate-audience" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "countries": [
      "string"
    ],
    "geoLocations": [
      "string"
    ],
    "industries": [
      "string"
    ],
    "jobFunctions": [
      "string"
    ],
    "seniorities": [
      "string"
    ]
  }'
Response · 200