Focus · LinkedIn
Typed Focus mode operations for LinkedIn accounts, generated from the LinkedIn focus module (same behaviour as the generic /accounts/{accountId}/focus routes).
focus_linkedin- Profile1
- Organizations4
- Brands1
- Admins2
- Posts10
- Images3
- Videos3
- Documents3
- Events6
- Comments8
- Reactions4
- Mentions2
- Notifications1
- Mention search2
- Insights1
- Followers1
- Demographics1
- Page statistics1
- Share statistics1
- Post analytics1
- Video analytics1
- Member post analytics1
- Org aggregate1
- Member aggregate1
- Webhook subscriptions3
- Targeting1
Profile
LinkedIn: Get Profile
/accounts/{accountId}/linkedin/profileGet 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.
Try it with MCPAsk your agent to call linkedin-profile-get (toolset focus_linkedin)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
idstringurnstringaccount_typestringorganizationmember
namestringvanity_namestring | nullheadlinestring | nullMember headline
descriptionstring | nullwebsitestring (uri) | nullindustriesarray of stringstaff_count_rangestring | nullorganization_typestring | nullprimary_organization_typestring | nullfounded_onobject | nullShow 3 child attributes
yearintegermonthintegerdayintegerspecialtiesarray of stringlocationsarray of objectShow 5 item attributes
citystringcountrystringline1stringpostal_codestringheadquarterbooleanlogo_urlstring (uri) | nullcover_photostring | nullfollowersinteger | nullconnectionsinteger | nullFirst-degree connections (r_1st_connections_size)
profile_urlstring (uri)Responses
Organizations
LinkedIn: List Pages
/accounts/{accountId}/linkedin/organizationsList 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.
Try it with MCPAsk your agent to call linkedin-organizations-list (toolset focus_linkedin)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 9 item attributes
idstringurnstringnamestringlocalizedNamestringvanityNamestring | nulllogoUrlstring (uri) | nullrolesarray of stringcanPostbooleanisAdminbooleanlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
LinkedIn: Get a Pages item
/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.
Try it with MCPAsk your agent to call linkedin-organizations-get (toolset focus_linkedin)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringurnstringnamestringlocalizedNamestringvanityNamestring | nulllogoUrlstring (uri) | nullrolesarray of stringcanPostbooleanisAdminbooleanResponses
LinkedIn: Use this Page (Pages)
/accounts/{accountId}/linkedin/organizations/{itemId}/switch-to-organizationSwitch 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.
Try it with MCPAsk your agent to call linkedin-organizations-switch-to-organization (toolset focus_linkedin)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique 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
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
LinkedIn: Use personal profile (Pages)
/accounts/{accountId}/linkedin/organizations/switch-to-personalUse 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.
Try it with MCPAsk your agent to call linkedin-organizations-switch-to-personal (toolset focus_linkedin)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique 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
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Brands
LinkedIn: List Showcase pages
/accounts/{accountId}/linkedin/brandsBrand / 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.
Try it with MCPAsk your agent to call linkedin-brands-list (toolset focus_linkedin)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 5 item attributes
idstringurnstringnamestringvanity_namestring | nulltypestring | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Admins
LinkedIn: List Page admins
/accounts/{accountId}/linkedin/adminsMembers 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.
Try it with MCPAsk your agent to call linkedin-admins-list (toolset focus_linkedin)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
rolestringADMINISTRATORCONTENT_ADMINISTRATORDIRECT_SPONSORED_CONTENT_POSTERRECRUITING_POSTERLEAD_CAPTURE_ADMINISTRATORLEAD_GEN_FORMS_MANAGERANALYSTCURATOR
statestringAPPROVEDREQUESTEDREJECTEDREVOKED
cursorstringOpaque cursor (start offset) from next_cursor
limitintegerdefault: 251–100
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 5 item attributes
idstringorganizationstringrole_assigneestringurn:li:person:…
rolestringADMINISTRATORCONTENT_ADMINISTRATORDIRECT_SPONSORED_CONTENT_POSTERRECRUITING_POSTERLEAD_CAPTURE_ADMINISTRATORLEAD_GEN_FORMS_MANAGERANALYSTCURATOR
statestringAPPROVEDREQUESTEDREJECTEDREVOKED
limitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
LinkedIn: Request DSC poster role (Page admins)
/accounts/{accountId}/linkedin/admins/request-dsc-roleRequest 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.
Try it with MCPAsk your agent to call linkedin-admins-request-dsc-role (toolset focus_linkedin)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique 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_urnstringReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Posts
LinkedIn: List Posts
/accounts/{accountId}/linkedin/postsList 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.
Try it with MCPAsk your agent to call linkedin-posts-list (toolset focus_linkedin)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
sort_bystringLAST_MODIFIEDCREATED
view_contextstringREADERAUTHOR
cursorstringOpaque cursor (start offset) from next_cursor
limitintegerdefault: 251–100
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 26 item attributes
idstringurn:li:share:… or urn:li:ugcPost:…
urlstring (uri)authorstringtextstring≤ 3000 characters
commentarystringRaw little-text commentary
typestringtextimagemulti_imagevideodocumentarticlepollreshareeventcelebrationcarousel
mentionsarray of objectShow 2 item attributes
namestringurnstringhashtagsarray of stringmediaarray of objectShow 3 item attributes
urnstringtitlestring | nullalt_textstring | nullarticleobject | nullShow 4 child attributes
urlstring (uri)titlestringdescriptionstringthumbnailstringpollobject | nullShow 4 child attributes
questionstringdurationstringunique_votersintegeroptionsarray of objectShow 2 item attributes
textstringvote_countinteger | nulleventstring | nullreshare_parentstring | nullreshare_rootstring | nullvisibilitystringPUBLICCONNECTIONSLOGGED_IN
feed_distributionstringMAIN_FEEDNONE
targetedbooleanlifecycle_statestringPUBLISHEDDRAFTPUBLISH_REQUESTEDPUBLISH_FAILED
is_reshare_disabledbooleaneditedbooleancta_labelstring | nullAPPLYDOWNLOADVIEW_QUOTELEARN_MORESIGN_UPSUBSCRIBEREGISTERJOINATTENDREQUEST_DEMOSEE_MOREBUY_NOWSHOP_NOW
landing_pagestring (uri) | nullsponsoredbooleancreated_atstring (date-time)published_atstring (date-time) | nullupdated_atstring (date-time) | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
LinkedIn: Create a Posts item
/accounts/{accountId}/linkedin/postsPublish 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.
Try it with MCPAsk your agent to call linkedin-posts-create (toolset focus_linkedin)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique 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 stringfirst_commentstring≤ 1250 characters
optionsobjectShow 21 child attributes
organizationUrnstringPublish as this organization (urn:li:organization:
visibilitystringdefault: "PUBLIC"CONNECTIONS is member-only.
PUBLICCONNECTIONSLOGGED_IN
feedDistributionstringdefault: "MAIN_FEED"NONE creates a dark post (organizations; used for ads).
MAIN_FEEDNONE
firstCommentstringPosted as the author right after publishing.
≤ 1250 characters
disableLinkPreviewbooleandefault: falseWhen false, a text post containing a URL becomes an article share built from the page OpenGraph tags.
disableResharebooleandefault: falseisReshareDisabledByAuthor
disableCommentsbooleandefault: falseClose comments after publishing (needs *_social_feed).
hashtagsbooleandefault: trueKeep #hashtags clickable (otherwise escaped as text).
mentionsarray of objectTurn the first plain "@Name" into a mention. Inline @Name syntax also works.
Show 2 item attributes
namestringrequiredurnstringrequiredpattern ^urn:li:(person|organization|organizationBrand):
documentTitlestringTitle of a document post (required by LinkedIn; defaults to media title or filename).
videoTitlestringthumbnailUrlstring (uri)Custom video thumbnail (also media[].thumbnail).
waitForVideobooleandefault: truePoll the video until AVAILABLE before creating the post.
videoProcessingTimeoutMsintegerdefault: 600000reshareUrlstringPost link or urn:li:share / ugcPost URN to repost. With text: repost with your thoughts. Mutually exclusive with media and polls.
articleobjectShow 6 child attributes
urlstring (uri)requiredtitlestringdescriptionstringthumbnailUrlstring (uri)thumbnailUrnstringpattern ^urn:li:image:
thumbnailAltTextstring≤ 4086 characters
pollobjectShow 3 child attributes
questionstringrequired1–140 characters
optionsarray of stringrequired2–4 items
durationstringdefault: "SEVEN_DAYS"ONE_DAYTHREE_DAYSSEVEN_DAYSFOURTEEN_DAYS
eventUrnstringShare a LinkedIn Event (content.reference).
pattern ^urn:li:(event|liveVideo):
callToActionobjectShow 2 child attributes
labelstringAPPLYDOWNLOADVIEW_QUOTELEARN_MORESIGN_UPSUBSCRIBEREGISTERJOINATTENDREQUEST_DEMOSEE_MOREBUY_NOWSHOP_NOW
landingPagestring (uri)geoRestrictionobjectOrganizations only; audience must exceed 300 members.
Show 1 child attributes
countriesarray of string1–25 items
audienceobjectTargeted 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 stringinterfaceLocalesarray of objectShow 2 item attributes
languagestringrequiredcountrystringrequiredindustriesarray of stringjobFunctionsarray of stringsenioritiesarray of stringstaffCountRangesarray of stringdegreesarray of stringfieldsOfStudyarray of stringorganizationsarray of stringReturns object
idstringurn:li:share:… or urn:li:ugcPost:…
urlstring (uri)authorstringtextstring≤ 3000 characters
commentarystringRaw little-text commentary
typestringtextimagemulti_imagevideodocumentarticlepollreshareeventcelebrationcarousel
mentionsarray of objectShow 2 item attributes
namestringurnstringhashtagsarray of stringmediaarray of objectShow 3 item attributes
urnstringtitlestring | nullalt_textstring | nullarticleobject | nullShow 4 child attributes
urlstring (uri)titlestringdescriptionstringthumbnailstringpollobject | nullShow 4 child attributes
questionstringdurationstringunique_votersintegeroptionsarray of objectShow 2 item attributes
textstringvote_countinteger | nulleventstring | nullreshare_parentstring | nullreshare_rootstring | nullvisibilitystringPUBLICCONNECTIONSLOGGED_IN
feed_distributionstringMAIN_FEEDNONE
targetedbooleanlifecycle_statestringPUBLISHEDDRAFTPUBLISH_REQUESTEDPUBLISH_FAILED
is_reshare_disabledbooleaneditedbooleancta_labelstring | nullAPPLYDOWNLOADVIEW_QUOTELEARN_MORESIGN_UPSUBSCRIBEREGISTERJOINATTENDREQUEST_DEMOSEE_MOREBUY_NOWSHOP_NOW
landing_pagestring (uri) | nullsponsoredbooleancreated_atstring (date-time)published_atstring (date-time) | nullupdated_atstring (date-time) | nullResponses
LinkedIn: Get a Posts item
/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.
Try it with MCPAsk your agent to call linkedin-posts-get (toolset focus_linkedin)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringurn:li:share:… or urn:li:ugcPost:…
urlstring (uri)authorstringtextstring≤ 3000 characters
commentarystringRaw little-text commentary
typestringtextimagemulti_imagevideodocumentarticlepollreshareeventcelebrationcarousel
mentionsarray of objectShow 2 item attributes
namestringurnstringhashtagsarray of stringmediaarray of objectShow 3 item attributes
urnstringtitlestring | nullalt_textstring | nullarticleobject | nullShow 4 child attributes
urlstring (uri)titlestringdescriptionstringthumbnailstringpollobject | nullShow 4 child attributes
questionstringdurationstringunique_votersintegeroptionsarray of objectShow 2 item attributes
textstringvote_countinteger | nulleventstring | nullreshare_parentstring | nullreshare_rootstring | nullvisibilitystringPUBLICCONNECTIONSLOGGED_IN
feed_distributionstringMAIN_FEEDNONE
targetedbooleanlifecycle_statestringPUBLISHEDDRAFTPUBLISH_REQUESTEDPUBLISH_FAILED
is_reshare_disabledbooleaneditedbooleancta_labelstring | nullAPPLYDOWNLOADVIEW_QUOTELEARN_MORESIGN_UPSUBSCRIBEREGISTERJOINATTENDREQUEST_DEMOSEE_MOREBUY_NOWSHOP_NOW
landing_pagestring (uri) | nullsponsoredbooleancreated_atstring (date-time)published_atstring (date-time) | nullupdated_atstring (date-time) | nullResponses
LinkedIn: Update a Posts item
/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.
Try it with MCPAsk your agent to call linkedin-posts-update (toolset focus_linkedin)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
textstring≤ 3000 characters
cta_labelstringAPPLYDOWNLOADVIEW_QUOTELEARN_MORESIGN_UPSUBSCRIBEREGISTERJOINATTENDREQUEST_DEMOSEE_MOREBUY_NOWSHOP_NOW
landing_pagestring (uri)Returns object
idstringurn:li:share:… or urn:li:ugcPost:…
urlstring (uri)authorstringtextstring≤ 3000 characters
commentarystringRaw little-text commentary
typestringtextimagemulti_imagevideodocumentarticlepollreshareeventcelebrationcarousel
mentionsarray of objectShow 2 item attributes
namestringurnstringhashtagsarray of stringmediaarray of objectShow 3 item attributes
urnstringtitlestring | nullalt_textstring | nullarticleobject | nullShow 4 child attributes
urlstring (uri)titlestringdescriptionstringthumbnailstringpollobject | nullShow 4 child attributes
questionstringdurationstringunique_votersintegeroptionsarray of objectShow 2 item attributes
textstringvote_countinteger | nulleventstring | nullreshare_parentstring | nullreshare_rootstring | nullvisibilitystringPUBLICCONNECTIONSLOGGED_IN
feed_distributionstringMAIN_FEEDNONE
targetedbooleanlifecycle_statestringPUBLISHEDDRAFTPUBLISH_REQUESTEDPUBLISH_FAILED
is_reshare_disabledbooleaneditedbooleancta_labelstring | nullAPPLYDOWNLOADVIEW_QUOTELEARN_MORESIGN_UPSUBSCRIBEREGISTERJOINATTENDREQUEST_DEMOSEE_MOREBUY_NOWSHOP_NOW
landing_pagestring (uri) | nullsponsoredbooleancreated_atstring (date-time)published_atstring (date-time) | nullupdated_atstring (date-time) | nullResponses
LinkedIn: Delete a Posts item
/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.
Try it with MCPAsk your agent to call linkedin-posts-delete (toolset focus_linkedin)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
LinkedIn: Turn off comments (Posts)
/accounts/{accountId}/linkedin/posts/{itemId}/close-commentsClosing 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.
Try it with MCPAsk your agent to call linkedin-posts-close-comments (toolset focus_linkedin)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
LinkedIn: Turn on comments (Posts)
/accounts/{accountId}/linkedin/posts/{itemId}/open-commentsTurn 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.
Try it with MCPAsk your agent to call linkedin-posts-open-comments (toolset focus_linkedin)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique 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
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
LinkedIn: Comment (Posts)
/accounts/{accountId}/linkedin/posts/{itemId}/commentComment. 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.
Try it with MCPAsk your agent to call linkedin-posts-comment (toolset focus_linkedin)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique 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
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
LinkedIn: React (Posts)
/accounts/{accountId}/linkedin/posts/{itemId}/reactReact. 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.
Try it with MCPAsk your agent to call linkedin-posts-react (toolset focus_linkedin)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique 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
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
LinkedIn: Repost with thoughts (Posts)
/accounts/{accountId}/linkedin/posts/{itemId}/reshareRepost 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.
Try it with MCPAsk your agent to call linkedin-posts-reshare (toolset focus_linkedin)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique 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
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Images
LinkedIn: List Images
/accounts/{accountId}/linkedin/imagesImages 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.
Try it with MCPAsk your agent to call linkedin-images-list (toolset focus_linkedin)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringOpaque cursor (start offset) from next_cursor
limitintegerdefault: 251–100
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 12 item attributes
idstringurn:li:image|video|document:…
ownerstringstatusstringWAITING_UPLOADPROCESSINGAVAILABLEPROCESSING_FAILED
download_urlstring (uri) | nulldownload_url_expires_atstring (date-time) | nullduration_msinteger | nullaspect_ratiostring | nullthumbnailstring (uri) | nullcaptionsstring (uri) | nulltitlestring | nullused_in_poststring | nullprocessing_failure_reasonstring | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
LinkedIn: Create a Images item
/accounts/{accountId}/linkedin/imagesUpload 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.
Try it with MCPAsk your agent to call linkedin-images-create (toolset focus_linkedin)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique 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_idstringurlstring (uri)Returns object
idstringurn:li:image|video|document:…
ownerstringstatusstringWAITING_UPLOADPROCESSINGAVAILABLEPROCESSING_FAILED
download_urlstring (uri) | nulldownload_url_expires_atstring (date-time) | nullduration_msinteger | nullaspect_ratiostring | nullthumbnailstring (uri) | nullcaptionsstring (uri) | nulltitlestring | nullused_in_poststring | nullprocessing_failure_reasonstring | nullResponses
LinkedIn: Get a Images item
/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.
Try it with MCPAsk your agent to call linkedin-images-get (toolset focus_linkedin)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringurn:li:image|video|document:…
ownerstringstatusstringWAITING_UPLOADPROCESSINGAVAILABLEPROCESSING_FAILED
download_urlstring (uri) | nulldownload_url_expires_atstring (date-time) | nullduration_msinteger | nullaspect_ratiostring | nullthumbnailstring (uri) | nullcaptionsstring (uri) | nulltitlestring | nullused_in_poststring | nullprocessing_failure_reasonstring | nullResponses
Videos
LinkedIn: List Videos
/accounts/{accountId}/linkedin/videosVideos 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.
Try it with MCPAsk your agent to call linkedin-videos-list (toolset focus_linkedin)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringOpaque cursor (start offset) from next_cursor
limitintegerdefault: 251–100
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 12 item attributes
idstringurn:li:image|video|document:…
ownerstringstatusstringWAITING_UPLOADPROCESSINGAVAILABLEPROCESSING_FAILED
download_urlstring (uri) | nulldownload_url_expires_atstring (date-time) | nullduration_msinteger | nullaspect_ratiostring | nullthumbnailstring (uri) | nullcaptionsstring (uri) | nulltitlestring | nullused_in_poststring | nullprocessing_failure_reasonstring | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
LinkedIn: Create a Videos item
/accounts/{accountId}/linkedin/videosUpload 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.
Try it with MCPAsk your agent to call linkedin-videos-create (toolset focus_linkedin)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique 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_idstringurlstring (uri)titlestringthumbnail_media_idstringcaptions_media_idstringEnglish SRT file
Returns object
idstringurn:li:image|video|document:…
ownerstringstatusstringWAITING_UPLOADPROCESSINGAVAILABLEPROCESSING_FAILED
download_urlstring (uri) | nulldownload_url_expires_atstring (date-time) | nullduration_msinteger | nullaspect_ratiostring | nullthumbnailstring (uri) | nullcaptionsstring (uri) | nulltitlestring | nullused_in_poststring | nullprocessing_failure_reasonstring | nullResponses
LinkedIn: Get a Videos item
/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.
Try it with MCPAsk your agent to call linkedin-videos-get (toolset focus_linkedin)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringurn:li:image|video|document:…
ownerstringstatusstringWAITING_UPLOADPROCESSINGAVAILABLEPROCESSING_FAILED
download_urlstring (uri) | nulldownload_url_expires_atstring (date-time) | nullduration_msinteger | nullaspect_ratiostring | nullthumbnailstring (uri) | nullcaptionsstring (uri) | nulltitlestring | nullused_in_poststring | nullprocessing_failure_reasonstring | nullResponses
Documents
LinkedIn: List Documents
/accounts/{accountId}/linkedin/documentsDocuments 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.
Try it with MCPAsk your agent to call linkedin-documents-list (toolset focus_linkedin)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringOpaque cursor (start offset) from next_cursor
limitintegerdefault: 251–100
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 12 item attributes
idstringurn:li:image|video|document:…
ownerstringstatusstringWAITING_UPLOADPROCESSINGAVAILABLEPROCESSING_FAILED
download_urlstring (uri) | nulldownload_url_expires_atstring (date-time) | nullduration_msinteger | nullaspect_ratiostring | nullthumbnailstring (uri) | nullcaptionsstring (uri) | nulltitlestring | nullused_in_poststring | nullprocessing_failure_reasonstring | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
LinkedIn: Create a Documents item
/accounts/{accountId}/linkedin/documentsUpload 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.
Try it with MCPAsk your agent to call linkedin-documents-create (toolset focus_linkedin)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique 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_idstringurlstring (uri)titlestringReturns object
idstringurn:li:image|video|document:…
ownerstringstatusstringWAITING_UPLOADPROCESSINGAVAILABLEPROCESSING_FAILED
download_urlstring (uri) | nulldownload_url_expires_atstring (date-time) | nullduration_msinteger | nullaspect_ratiostring | nullthumbnailstring (uri) | nullcaptionsstring (uri) | nulltitlestring | nullused_in_poststring | nullprocessing_failure_reasonstring | nullResponses
LinkedIn: Get a Documents item
/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.
Try it with MCPAsk your agent to call linkedin-documents-get (toolset focus_linkedin)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringurn:li:image|video|document:…
ownerstringstatusstringWAITING_UPLOADPROCESSINGAVAILABLEPROCESSING_FAILED
download_urlstring (uri) | nulldownload_url_expires_atstring (date-time) | nullduration_msinteger | nullaspect_ratiostring | nullthumbnailstring (uri) | nullcaptionsstring (uri) | nulltitlestring | nullused_in_poststring | nullprocessing_failure_reasonstring | nullResponses
Events
LinkedIn: List Events
/accounts/{accountId}/linkedin/eventsLinkedIn 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.
Try it with MCPAsk your agent to call linkedin-events-list (toolset focus_linkedin)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
lifecyclestringUPCOMINGONGOINGPAST
exclude_cancelledbooleanentry_criteriastringPUBLICGATED
sort_orderstringSTART_TIME_ASCEND_TIME_DESC
cursorstringOpaque cursor (start offset) from next_cursor
limitintegerdefault: 251–100
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 18 item attributes
idstringurnstringnamestring≤ 255 characters
descriptionstring | nulltypestringlive_videoexternalin_person
organizerstringstarts_atstring (date-time)ends_atstring (date-time) | nullurlstring (uri) | nulladdressobject | nullShow 5 child attributes
line1stringcitystringgeographicAreastringpostalCodestringcountrystringvenue_detailsstring | nullvanity_namestring | nulldiscovery_modestring | nullLISTEDURL_ONLY
background_imagestring | nulllive_videostring | nullugc_poststring | nullcreated_atstring (date-time) | nullupdated_atstring (date-time) | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
LinkedIn: Create a Events item
/accounts/{accountId}/linkedin/eventsLinkedIn 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.
Try it with MCPAsk your agent to call linkedin-events-create (toolset focus_linkedin)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique 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
namestringtypestringlive_videoexternalin_person
starts_atstring (date-time)ends_atstring (date-time)descriptionstringurlstring (uri)addressobjectShow 5 child attributes
line1stringcitystringgeographicAreastringpostalCodestringcountrystringvenue_detailsstringvanity_namestringdiscovery_modestringLISTEDURL_ONLY
background_imagestringurn:li:digitalmediaAsset:…
privacy_policy_urlstring (uri)Attach a templated lead gen registration form
test_eventbooleanpostbooleandefault: trueShare the event to the feed (required for it to be visible)
commentarystringReturns object
idstringurnstringnamestring≤ 255 characters
descriptionstring | nulltypestringlive_videoexternalin_person
organizerstringstarts_atstring (date-time)ends_atstring (date-time) | nullurlstring (uri) | nulladdressobject | nullShow 5 child attributes
line1stringcitystringgeographicAreastringpostalCodestringcountrystringvenue_detailsstring | nullvanity_namestring | nulldiscovery_modestring | nullLISTEDURL_ONLY
background_imagestring | nulllive_videostring | nullugc_poststring | nullcreated_atstring (date-time) | nullupdated_atstring (date-time) | nullResponses
LinkedIn: Get a Events item
/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.
Try it with MCPAsk your agent to call linkedin-events-get (toolset focus_linkedin)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringurnstringnamestring≤ 255 characters
descriptionstring | nulltypestringlive_videoexternalin_person
organizerstringstarts_atstring (date-time)ends_atstring (date-time) | nullurlstring (uri) | nulladdressobject | nullShow 5 child attributes
line1stringcitystringgeographicAreastringpostalCodestringcountrystringvenue_detailsstring | nullvanity_namestring | nulldiscovery_modestring | nullLISTEDURL_ONLY
background_imagestring | nulllive_videostring | nullugc_poststring | nullcreated_atstring (date-time) | nullupdated_atstring (date-time) | nullResponses
LinkedIn: Update a Events item
/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.
Try it with MCPAsk your agent to call linkedin-events-update (toolset focus_linkedin)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
namestringtypestringlive_videoexternalin_person
starts_atstring (date-time)ends_atstring (date-time)descriptionstringurlstring (uri)addressobjectShow 5 child attributes
line1stringcitystringgeographicAreastringpostalCodestringcountrystringvenue_detailsstringvanity_namestringdiscovery_modestringLISTEDURL_ONLY
background_imagestringurn:li:digitalmediaAsset:…
privacy_policy_urlstring (uri)Attach a templated lead gen registration form
test_eventbooleanpostbooleandefault: trueShare the event to the feed (required for it to be visible)
commentarystringReturns object
idstringurnstringnamestring≤ 255 characters
descriptionstring | nulltypestringlive_videoexternalin_person
organizerstringstarts_atstring (date-time)ends_atstring (date-time) | nullurlstring (uri) | nulladdressobject | nullShow 5 child attributes
line1stringcitystringgeographicAreastringpostalCodestringcountrystringvenue_detailsstring | nullvanity_namestring | nulldiscovery_modestring | nullLISTEDURL_ONLY
background_imagestring | nulllive_videostring | nullugc_poststring | nullcreated_atstring (date-time) | nullupdated_atstring (date-time) | nullResponses
LinkedIn: Delete a Events item
/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.
Try it with MCPAsk your agent to call linkedin-events-delete (toolset focus_linkedin)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
LinkedIn: Share to feed (Events)
/accounts/{accountId}/linkedin/events/{itemId}/postShare 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.
Try it with MCPAsk your agent to call linkedin-events-post (toolset focus_linkedin)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique 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
commentarystringtypestringlive_videoexternalin_person
live_videostringReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Comments
LinkedIn: List Comments
/accounts/{accountId}/linkedin/commentsComments 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.
Try it with MCPAsk your agent to call linkedin-comments-list (toolset focus_linkedin)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
post_idstringPost URN (share / ugcPost / activity)
comment_idstringList replies of this comment URN instead
cursorstringOpaque cursor (start offset) from next_cursor
limitintegerdefault: 251–100
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 17 item attributes
idstringComposite URN urn:li:comment:(thread,id)
textstring≤ 1250 characters
authorstringActor URN (person or organization)
author_typestringpersonorganization
agentstring | nullMember who commented on behalf of the Page
created_atstring (date-time)updated_atstring (date-time) | nulleditedbooleanlike_countintegerliked_by_mebooleanreply_countintegercomment_idstringpost_idstringparent_idstring | nullis_ownbooleanattachmentsarray of objectShow 3 item attributes
typestringurnstring | nullurlstring (uri) | nullmentionsarray of objectShow 3 item attributes
startintegerlengthintegerurnstringlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
LinkedIn: Create a Comments item
/accounts/{accountId}/linkedin/commentsComment 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.
Try it with MCPAsk your agent to call linkedin-comments-create (toolset focus_linkedin)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique 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_idstringparent_comment_idstringReply to this comment URN
textstringrequired≤ 1250 characters
image_media_idstringmentionsarray of objectShow 3 item attributes
startintegerlengthintegerurnstringReturns object
idstringComposite URN urn:li:comment:(thread,id)
textstring≤ 1250 characters
authorstringActor URN (person or organization)
author_typestringpersonorganization
agentstring | nullMember who commented on behalf of the Page
created_atstring (date-time)updated_atstring (date-time) | nulleditedbooleanlike_countintegerliked_by_mebooleanreply_countintegercomment_idstringpost_idstringparent_idstring | nullis_ownbooleanattachmentsarray of objectShow 3 item attributes
typestringurnstring | nullurlstring (uri) | nullmentionsarray of objectShow 3 item attributes
startintegerlengthintegerurnstringResponses
LinkedIn: Get a Comments item
/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.
Try it with MCPAsk your agent to call linkedin-comments-get (toolset focus_linkedin)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringComposite URN urn:li:comment:(thread,id)
textstring≤ 1250 characters
authorstringActor URN (person or organization)
author_typestringpersonorganization
agentstring | nullMember who commented on behalf of the Page
created_atstring (date-time)updated_atstring (date-time) | nulleditedbooleanlike_countintegerliked_by_mebooleanreply_countintegercomment_idstringpost_idstringparent_idstring | nullis_ownbooleanattachmentsarray of objectShow 3 item attributes
typestringurnstring | nullurlstring (uri) | nullmentionsarray of objectShow 3 item attributes
startintegerlengthintegerurnstringResponses
LinkedIn: Update a Comments item
/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.
Try it with MCPAsk your agent to call linkedin-comments-update (toolset focus_linkedin)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
textstringrequired≤ 1250 characters
Returns object
idstringComposite URN urn:li:comment:(thread,id)
textstring≤ 1250 characters
authorstringActor URN (person or organization)
author_typestringpersonorganization
agentstring | nullMember who commented on behalf of the Page
created_atstring (date-time)updated_atstring (date-time) | nulleditedbooleanlike_countintegerliked_by_mebooleanreply_countintegercomment_idstringpost_idstringparent_idstring | nullis_ownbooleanattachmentsarray of objectShow 3 item attributes
typestringurnstring | nullurlstring (uri) | nullmentionsarray of objectShow 3 item attributes
startintegerlengthintegerurnstringResponses
LinkedIn: Delete a Comments item
/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.
Try it with MCPAsk your agent to call linkedin-comments-delete (toolset focus_linkedin)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
LinkedIn: React (Comments)
/accounts/{accountId}/linkedin/comments/{itemId}/likeReact. 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.
Try it with MCPAsk your agent to call linkedin-comments-like (toolset focus_linkedin)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique 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
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
LinkedIn: Remove reaction (Comments)
/accounts/{accountId}/linkedin/comments/{itemId}/unlikeRemove 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.
Try it with MCPAsk your agent to call linkedin-comments-unlike (toolset focus_linkedin)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique 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
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
LinkedIn: Reply (Comments)
/accounts/{accountId}/linkedin/comments/{itemId}/replyReply. 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.
Try it with MCPAsk your agent to call linkedin-comments-reply (toolset focus_linkedin)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique 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
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reactions
LinkedIn: List Reactions
/accounts/{accountId}/linkedin/reactionsIndividual 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.
Try it with MCPAsk your agent to call linkedin-reactions-list (toolset focus_linkedin)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
entitystringrequiredPost or comment URN
sortstringREVERSE_CHRONOLOGICALCHRONOLOGICALRELEVANCE
cursorstringOpaque cursor (start offset) from next_cursor
limitintegerdefault: 251–100
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 6 item attributes
idstringreaction_typestringLIKEPRAISEEMPATHYINTERESTAPPRECIATIONENTERTAINMENT
actorstringactor_typestringpersonorganization
rootstringcreated_atstring (date-time)limitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
LinkedIn: Create a Reactions item
/accounts/{accountId}/linkedin/reactionsReact 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.
Try it with MCPAsk your agent to call linkedin-reactions-create (toolset focus_linkedin)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique 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
entitystringrequiredreaction_typestringdefault: "LIKE"LIKEPRAISEEMPATHYINTERESTAPPRECIATIONENTERTAINMENT
Returns object
idstringreaction_typestringLIKEPRAISEEMPATHYINTERESTAPPRECIATIONENTERTAINMENT
actorstringactor_typestringpersonorganization
rootstringcreated_atstring (date-time)Responses
LinkedIn: Delete a Reactions item
/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.
Try it with MCPAsk your agent to call linkedin-reactions-delete (toolset focus_linkedin)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
LinkedIn: Reaction breakdown (Reactions)
/accounts/{accountId}/linkedin/reactions/summaryReaction 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.
Try it with MCPAsk your agent to call linkedin-reactions-summary (toolset focus_linkedin)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique 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
entitystringrequiredReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mentions
LinkedIn: List Mentions
/accounts/{accountId}/linkedin/mentionsPosts 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.
Try it with MCPAsk your agent to call linkedin-mentions-list (toolset focus_linkedin)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
sincestring (date-time)untilstring (date-time)cursorstringOpaque cursor (start offset) from next_cursor
limitintegerdefault: 251–100
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 10 item attributes
idstringtypestringmention
kindstringpostcomment
post_idstringcomment_idstring | nullauthorstring | nulltextstring | nullorganizationstringcreated_atstring (date-time)urlstring (uri)limitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
LinkedIn: Reply as Page (Mentions)
/accounts/{accountId}/linkedin/mentions/{itemId}/replyReply 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.
Try it with MCPAsk your agent to call linkedin-mentions-reply (toolset focus_linkedin)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique 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_idstringcomment_idstringmessagestringrequired≤ 1250 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Notifications
LinkedIn: List Page activity
/accounts/{accountId}/linkedin/notificationsLikes, 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.
Try it with MCPAsk your agent to call linkedin-notifications-list (toolset focus_linkedin)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
actionsarray of stringsource_poststringsincestring (date-time)untilstring (date-time)cursorstringOpaque cursor (start offset) from next_cursor
limitintegerdefault: 251–100
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 10 item attributes
idstringactionstringLIKECOMMENTSHARESHARE_MENTIONADMIN_COMMENTCOMMENT_EDITCOMMENT_DELETE
kindstringpostcomment
organizationstringsource_poststring | nullgenerated_activitystring | nullauthorstring | nulltextstring | nullcreated_atstring (date-time)urlstring (uri) | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Mention search
LinkedIn: List Mention picker
/accounts/{accountId}/linkedin/mention-searchFind 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.
Try it with MCPAsk your agent to call linkedin-mention-search-list (toolset focus_linkedin)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
keywordsstringrequired≥ 3 characters
organization_urnstringReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 7 item attributes
urnstringnamestringfirst_namestringlast_namestringheadlinestring | nullphoto_urnstring | nullmention_formatstringlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
LinkedIn: Resolve URL (Mention picker)
/accounts/{accountId}/linkedin/mention-search/resolveResolve 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.
Try it with MCPAsk your agent to call linkedin-mention-search-resolve (toolset focus_linkedin)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique 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
urlstringrequireddisplay_namestringorganization_urnstringReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Insights
LinkedIn: Get Overview
/accounts/{accountId}/linkedin/insightsDaily 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.
Try it with MCPAsk your agent to call linkedin-insights-get (toolset focus_linkedin)Set up MCP
Path parameters
accountIdstringrequiredSocial 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 objectShow 1 item attributes
datestring (date)totalsobjectResponses
Followers
LinkedIn: Get Followers
/accounts/{accountId}/linkedin/followersFollower 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.
Try it with MCPAsk your agent to call linkedin-followers-get (toolset focus_linkedin)Set up MCP
Path parameters
accountIdstringrequiredSocial 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
totalintegergranularitystringDAYWEEKMONTH
seriesarray of objectShow 5 item attributes
datestring (date)organicintegerpaidintegertotalintegervalueintegerResponses
Demographics
LinkedIn: Get Follower demographics
/accounts/{accountId}/linkedin/demographicsLifetime 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.
Try it with MCPAsk your agent to call linkedin-demographics-get (toolset focus_linkedin)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
countriesarray of objectShow 2 item attributes
keystringvalueintegerregionsarray of objectShow 2 item attributes
keystringvalueintegersenioritiesarray of objectShow 2 item attributes
keystringvalueintegerindustriesarray of objectShow 2 item attributes
keystringvalueintegerfunctionsarray of objectShow 2 item attributes
keystringvalueintegercompany_sizesarray of objectShow 2 item attributes
keystringvalueintegerassociation_typesarray of objectShow 2 item attributes
keystringvalueintegerResponses
Page statistics
LinkedIn: Get Page views
/accounts/{accountId}/linkedin/page-statisticsPage 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.
Try it with MCPAsk your agent to call linkedin-page-statistics-get (toolset focus_linkedin)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
sincestring (date)Inclusive start date (YYYY-MM-DD)
untilstring (date)Inclusive end date (YYYY-MM-DD)
granularitystringDAYMONTH
brandstringurn:li:organizationBrand:… (showcase page)
Returns object
totalsobjectseriesarray of objectShow 1 item attributes
datestring (date)countriesarray of objectShow 2 item attributes
keystringvalueintegerregionsarray of objectShow 2 item attributes
keystringvalueintegersenioritiesarray of objectShow 2 item attributes
keystringvalueintegerindustriesarray of objectShow 2 item attributes
keystringvalueintegerfunctionsarray of objectShow 2 item attributes
keystringvalueintegercompany_sizesarray of objectShow 2 item attributes
keystringvalueintegerResponses
Share statistics
LinkedIn: Get Post performance
/accounts/{accountId}/linkedin/share-statisticsOrganic 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.
Try it with MCPAsk your agent to call linkedin-share-statistics-get (toolset focus_linkedin)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
sincestring (date)Inclusive start date (YYYY-MM-DD)
untilstring (date)Inclusive end date (YYYY-MM-DD)
granularitystringDAYMONTH
Returns object
lifetimeobjectseriesarray of objectShow 1 item attributes
datestring (date)Responses
Post analytics
LinkedIn: Get a Post analytics item
/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.
Try it with MCPAsk your agent to call linkedin-post-analytics-get (toolset focus_linkedin)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
external_idstringimpressionsintegerreachintegerlikesintegercommentsintegersharesintegerclicksintegersavesintegerviewsintegerengagementsintegerengagement_ratenumberResponses
Video analytics
LinkedIn: Get Video analytics
/accounts/{accountId}/linkedin/video-analyticsViews, 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.
Try it with MCPAsk your agent to call linkedin-video-analytics-get (toolset focus_linkedin)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
post_idstringrequiredsincestring (date)Inclusive start date (YYYY-MM-DD)
untilstring (date)Inclusive end date (YYYY-MM-DD)
aggregationstringALLDAYWEEK
Returns object
post_idstringrowsarray of objectShow 3 item attributes
typestringdatestring | nullvaluenumberResponses
Member post analytics
LinkedIn: Get Creator analytics
/accounts/{accountId}/linkedin/member-post-analyticsMember 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.
Try it with MCPAsk your agent to call linkedin-member-post-analytics-get (toolset focus_linkedin)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
post_idstringmetricsarray of stringaggregationstringdefault: "TOTAL"TOTALDAILY
sincestring (date)Inclusive start date (YYYY-MM-DD)
untilstring (date)Inclusive end date (YYYY-MM-DD)
Returns object
rowsarray of objectShow 3 item attributes
metricstringIMPRESSIONMEMBERS_REACHEDRESHAREREACTIONCOMMENTPOST_SAVEPOST_SENDLINK_CLICKSPREMIUM_CTA_CLICKSFOLLOWER_GAINED_FROM_CONTENTPROFILE_VIEW_FROM_CONTENT
datestring | nullvaluenumberResponses
Org aggregate
LinkedIn: Get Page analytics (aggregate)
/accounts/{accountId}/linkedin/org-aggregateZernio-compatible organization aggregate analytics (max 89 days). Requires scopes: rw_organization_admin. Generic route: /v1/accounts/{accountId}/focus/org-aggregate.
Try it with MCPAsk your agent to call linkedin-org-aggregate-get (toolset focus_linkedin)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
metricsarray of stringmetric_typestringtime_seriestotal_value
sincestring (date)Inclusive start date (YYYY-MM-DD)
untilstring (date)Inclusive end date (YYYY-MM-DD)
Returns object
dateRangeobjectShow 2 child attributes
sincestringuntilstringmetricTypestringtime_seriestotal_value
metricsobjectunavailableMetricsarray of stringResponses
Member aggregate
LinkedIn: Get Profile analytics (aggregate)
/accounts/{accountId}/linkedin/member-aggregateZernio-compatible aggregated analytics across the member's posts. Requires scopes: r_member_postAnalytics. Generic route: /v1/accounts/{accountId}/focus/member-aggregate.
Try it with MCPAsk your agent to call linkedin-member-aggregate-get (toolset focus_linkedin)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
aggregationstringTOTALDAILY
metricsarray of stringsincestring (date)Inclusive start date (YYYY-MM-DD)
untilstring (date)Inclusive end date (YYYY-MM-DD)
Returns object
aggregationstringTOTALDAILY
analyticsobjectskippedMetricsarray of stringResponses
Webhook subscriptions
LinkedIn: List Real-time notifications
/accounts/{accountId}/linkedin/webhook-subscriptionsWebhook 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.
Try it with MCPAsk your agent to call linkedin-webhook-subscriptions-list (toolset focus_linkedin)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 6 item attributes
idstringorganizationstringuserstringevent_typestringORGANIZATION_SOCIAL_ACTION_NOTIFICATIONS
webhookstring (uri)expires_atstring (date-time) | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
LinkedIn: Create a Real-time notifications item
/accounts/{accountId}/linkedin/webhook-subscriptionsSubscribe 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.
Try it with MCPAsk your agent to call linkedin-webhook-subscriptions-create (toolset focus_linkedin)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique 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)requiredorganization_urnstringdeveloper_app_idstringDefaults to LINKEDIN_ORG_APP_ID
Returns object
idstringorganizationstringuserstringevent_typestringORGANIZATION_SOCIAL_ACTION_NOTIFICATIONS
webhookstring (uri)expires_atstring (date-time) | nullResponses
LinkedIn: Delete a Real-time notifications item
/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.
Try it with MCPAsk your agent to call linkedin-webhook-subscriptions-delete (toolset focus_linkedin)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Targeting
LinkedIn: Estimate audience (Audience targeting)
/accounts/{accountId}/linkedin/targeting/estimate-audienceEstimate 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.
Try it with MCPAsk your agent to call linkedin-targeting-estimate-audience (toolset focus_linkedin)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique 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 stringgeoLocationsarray of stringindustriesarray of stringjobFunctionsarray of stringsenioritiesarray of stringstaffCountRangesarray of stringdegreesarray of stringfieldsOfStudyarray of stringorganizationsarray of stringReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)