# Focus · LinkedIn API

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

Base URL: `https://api.socialit.com/v1`. Authenticate with `Authorization: Bearer <API key or OAuth token>`.

## 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` · MCP tool: `linkedin-profile-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/profile" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "urn": "string",
  "account_type": "organization",
  "name": "string",
  "vanity_name": "string",
  "headline": "string",
  "description": "string",
  "website": "https://example.com",
  "industries": [
    "string"
  ],
  "staff_count_range": "string",
  "organization_type": "string",
  "primary_organization_type": "string",
  "founded_on": {
    "year": 1,
    "month": 1,
    "day": 1
  },
  "specialties": [
    "string"
  ],
  "locations": [
    {
      "city": "string",
      "country": "US",
      "line1": "string",
      "postal_code": "string",
      "headquarter": true
    }
  ],
  "logo_url": "https://example.com",
  "cover_photo": "string",
  "followers": 1,
  "connections": 1,
  "profile_url": "https://example.com"
}
```

## 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: `read` · MCP tool: `linkedin-organizations-list` · Zernio: `GET /v1/accounts/{accountId}/linkedin-organizations`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/organizations" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "urn": "string",
      "name": "string",
      "localizedName": "string",
      "vanityName": "string",
      "logoUrl": "https://example.com",
      "roles": [
        "ADMINISTRATOR"
      ],
      "canPost": true,
      "isAdmin": true
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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` · MCP tool: `linkedin-organizations-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/organizations/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "urn": "string",
  "name": "string",
  "localizedName": "string",
  "vanityName": "string",
  "logoUrl": "https://example.com",
  "roles": [
    "ADMINISTRATOR"
  ],
  "canPost": true,
  "isAdmin": true
}
```

## 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: `write` · MCP tool: `linkedin-organizations-switch-to-organization` · Zernio: `PUT /v1/accounts/{accountId}/linkedin-organization`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `linkedin-organizations-switch-to-personal`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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` · MCP tool: `linkedin-brands-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/brands" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "urn": "string",
      "name": "string",
      "vanity_name": "string",
      "type": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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` · MCP tool: `linkedin-admins-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `role` (string; one of ADMINISTRATOR, CONTENT_ADMINISTRATOR, DIRECT_SPONSORED_CONTENT_POSTER, RECRUITING_POSTER, LEAD_CAPTURE_ADMINISTRATOR, LEAD_GEN_FORMS_MANAGER, ANALYST, CURATOR)
- `state` (string; one of APPROVED, REQUESTED, REJECTED, REVOKED)
- `cursor` (string): Opaque cursor (start offset) from next_cursor
- `limit` (integer; 1–100)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/admins" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "organization": "string",
      "role_assignee": "string",
      "role": "ADMINISTRATOR",
      "state": "APPROVED"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `linkedin-admins-request-dsc-role`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `organization_urn` (string)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `read` · MCP tool: `linkedin-posts-list` · Zernio: `GET /v1/accounts/{accountId}/posts`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `sort_by` (string; one of LAST_MODIFIED, CREATED)
- `view_context` (string; one of READER, AUTHOR)
- `cursor` (string): Opaque cursor (start offset) from next_cursor
- `limit` (integer; 1–100)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/posts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "url": "https://example.com",
      "author": "string",
      "text": "string",
      "commentary": "string",
      "type": "text",
      "mentions": [
        {
          "name": "string",
          "urn": "string"
        }
      ],
      "hashtags": [
        "string"
      ],
      "media": [
        {
          "urn": "string",
          "title": "string",
          "alt_text": "string"
        }
      ],
      "article": {
        "url": "https://example.com",
        "title": "string",
        "description": "string",
        "thumbnail": "string"
      },
      "poll": {
        "question": "string",
        "duration": "string",
        "unique_voters": 1,
        "options": [
          {
            "text": null,
            "vote_count": null
          }
        ]
      },
      "event": "string",
      "reshare_parent": "string",
      "reshare_root": "string",
      "visibility": "PUBLIC",
      "feed_distribution": "MAIN_FEED",
      "targeted": true,
      "lifecycle_state": "PUBLISHED",
      "is_reshare_disabled": true,
      "edited": true,
      "cta_label": "APPLY",
      "landing_page": "https://example.com",
      "sponsored": true,
      "created_at": "2026-10-13T09:00:00.000Z",
      "published_at": "2026-10-13T09:00:00.000Z",
      "updated_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `linkedin-posts-create` · Zernio: `POST /v1/posts/{postId}/edit`, `POST /v1/posts/{postId}/unpublish`, `POST /v1/posts/sync-external`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `text` (string; ≤ 3000 characters)
- `media_ids` (array of string)
- `first_comment` (string; ≤ 1250 characters)
- `options` (object)
  - `options.organizationUrn` (string): Publish as this organization (urn:li:organization:) instead of the account default. The member must be ADMINISTRATOR, CONTENT_ADMINISTRATOR or DSC poster.
  - `options.visibility` (string; one of PUBLIC, CONNECTIONS, LOGGED_IN): CONNECTIONS is member-only.
  - `options.feedDistribution` (string; one of MAIN_FEED, NONE): NONE creates a dark post (organizations; used for ads).
  - `options.firstComment` (string; ≤ 1250 characters): Posted as the author right after publishing.
  - `options.disableLinkPreview` (boolean): When false, a text post containing a URL becomes an article share built from the page OpenGraph tags.
  - `options.disableReshare` (boolean): isReshareDisabledByAuthor
  - `options.disableComments` (boolean): Close comments after publishing (needs *_social_feed).
  - `options.hashtags` (boolean): Keep #hashtags clickable (otherwise escaped as text).
  - `options.mentions` (array of object): Turn the first plain "@Name" into a mention. Inline @Name syntax also works.
    - `options.mentions[].name` (string; required)
    - `options.mentions[].urn` (string; required; pattern ^urn:li:(person|organization|organizationBrand):)
  - `options.documentTitle` (string): Title of a document post (required by LinkedIn; defaults to media title or filename).
  - `options.videoTitle` (string)
  - `options.thumbnailUrl` (string (uri)): Custom video thumbnail (also media[].thumbnail).
  - `options.waitForVideo` (boolean): Poll the video until AVAILABLE before creating the post.
  - `options.videoProcessingTimeoutMs` (integer)
  - `options.reshareUrl` (string): Post link or urn:li:share / ugcPost URN to repost. With text: repost with your thoughts. Mutually exclusive with media and polls.
  - `options.article` (object)
    - `options.article.url` (string (uri); required)
    - `options.article.title` (string)
    - `options.article.description` (string)
    - `options.article.thumbnailUrl` (string (uri))
    - `options.article.thumbnailUrn` (string; pattern ^urn:li:image:)
    - `options.article.thumbnailAltText` (string; ≤ 4086 characters)
  - `options.poll` (object)
    - `options.poll.question` (string; required; 1–140 characters)
    - `options.poll.options` (array of string; required; 2–4 items)
    - `options.poll.duration` (string; one of ONE_DAY, THREE_DAYS, SEVEN_DAYS, FOURTEEN_DAYS)
  - `options.eventUrn` (string; pattern ^urn:li:(event|liveVideo):): Share a LinkedIn Event (content.reference).
  - `options.callToAction` (object)
    - `options.callToAction.label` (string; one of APPLY, DOWNLOAD, VIEW_QUOTE, LEARN_MORE, SIGN_UP, SUBSCRIBE, REGISTER, JOIN, ATTEND, REQUEST_DEMO, SEE_MORE, BUY_NOW, …)
    - `options.callToAction.landingPage` (string (uri))
  - `options.geoRestriction` (object): Organizations only; audience must exceed 300 members.
    - `options.geoRestriction.countries` (array of string; 1–25 items)
  - `options.audience` (object): Targeted organic post (distribution.targetEntities). Organizations only; OR within a facet, AND across facets; >300 members.
    - `options.audience.countries` (array of string; ≤ 25 items)
    - `options.audience.geoLocations` (array of string)
    - `options.audience.interfaceLocales` (array of object)
      - `options.audience.interfaceLocales[].language` (string; required)
      - `options.audience.interfaceLocales[].country` (string; required)
    - `options.audience.industries` (array of string)
    - `options.audience.jobFunctions` (array of string)
    - `options.audience.seniorities` (array of string)
    - `options.audience.staffCountRanges` (array of string)
    - `options.audience.degrees` (array of string)
    - `options.audience.fieldsOfStudy` (array of string)
    - `options.audience.organizations` (array of string)

```bash
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:

```json
{
  "id": "string",
  "url": "https://example.com",
  "author": "string",
  "text": "string",
  "commentary": "string",
  "type": "text",
  "mentions": [
    {
      "name": "string",
      "urn": "string"
    }
  ],
  "hashtags": [
    "string"
  ],
  "media": [
    {
      "urn": "string",
      "title": "string",
      "alt_text": "string"
    }
  ],
  "article": {
    "url": "https://example.com",
    "title": "string",
    "description": "string",
    "thumbnail": "string"
  },
  "poll": {
    "question": "string",
    "duration": "string",
    "unique_voters": 1,
    "options": [
      {
        "text": "string",
        "vote_count": 1
      }
    ]
  },
  "event": "string",
  "reshare_parent": "string",
  "reshare_root": "string",
  "visibility": "PUBLIC",
  "feed_distribution": "MAIN_FEED",
  "targeted": true,
  "lifecycle_state": "PUBLISHED",
  "is_reshare_disabled": true,
  "edited": true,
  "cta_label": "APPLY",
  "landing_page": "https://example.com",
  "sponsored": true,
  "created_at": "2026-10-13T09:00:00.000Z",
  "published_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z"
}
```

## 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` · MCP tool: `linkedin-posts-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/posts/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "url": "https://example.com",
  "author": "string",
  "text": "string",
  "commentary": "string",
  "type": "text",
  "mentions": [
    {
      "name": "string",
      "urn": "string"
    }
  ],
  "hashtags": [
    "string"
  ],
  "media": [
    {
      "urn": "string",
      "title": "string",
      "alt_text": "string"
    }
  ],
  "article": {
    "url": "https://example.com",
    "title": "string",
    "description": "string",
    "thumbnail": "string"
  },
  "poll": {
    "question": "string",
    "duration": "string",
    "unique_voters": 1,
    "options": [
      {
        "text": "string",
        "vote_count": 1
      }
    ]
  },
  "event": "string",
  "reshare_parent": "string",
  "reshare_root": "string",
  "visibility": "PUBLIC",
  "feed_distribution": "MAIN_FEED",
  "targeted": true,
  "lifecycle_state": "PUBLISHED",
  "is_reshare_disabled": true,
  "edited": true,
  "cta_label": "APPLY",
  "landing_page": "https://example.com",
  "sponsored": true,
  "created_at": "2026-10-13T09:00:00.000Z",
  "published_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z"
}
```

## 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` · MCP tool: `linkedin-posts-update`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Body

- `text` (string; ≤ 3000 characters)
- `cta_label` (string; one of APPLY, DOWNLOAD, VIEW_QUOTE, LEARN_MORE, SIGN_UP, SUBSCRIBE, REGISTER, JOIN, ATTEND, REQUEST_DEMO, SEE_MORE, BUY_NOW, …)
- `landing_page` (string (uri))

```bash
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:

```json
{
  "id": "string",
  "url": "https://example.com",
  "author": "string",
  "text": "string",
  "commentary": "string",
  "type": "text",
  "mentions": [
    {
      "name": "string",
      "urn": "string"
    }
  ],
  "hashtags": [
    "string"
  ],
  "media": [
    {
      "urn": "string",
      "title": "string",
      "alt_text": "string"
    }
  ],
  "article": {
    "url": "https://example.com",
    "title": "string",
    "description": "string",
    "thumbnail": "string"
  },
  "poll": {
    "question": "string",
    "duration": "string",
    "unique_voters": 1,
    "options": [
      {
        "text": "string",
        "vote_count": 1
      }
    ]
  },
  "event": "string",
  "reshare_parent": "string",
  "reshare_root": "string",
  "visibility": "PUBLIC",
  "feed_distribution": "MAIN_FEED",
  "targeted": true,
  "lifecycle_state": "PUBLISHED",
  "is_reshare_disabled": true,
  "edited": true,
  "cta_label": "APPLY",
  "landing_page": "https://example.com",
  "sponsored": true,
  "created_at": "2026-10-13T09:00:00.000Z",
  "published_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z"
}
```

## 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` · MCP tool: `linkedin-posts-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/posts/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## 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` · MCP tool: `linkedin-posts-close-comments`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `linkedin-posts-open-comments`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `linkedin-posts-comment`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `text` (string; required; ≤ 1250 characters)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `linkedin-posts-react`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `reaction_type` (string; one of LIKE, PRAISE, EMPATHY, INTEREST, APPRECIATION, ENTERTAINMENT)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `linkedin-posts-reshare`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `text` (string; ≤ 3000 characters)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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` · MCP tool: `linkedin-images-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `cursor` (string): Opaque cursor (start offset) from next_cursor
- `limit` (integer; 1–100)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/images" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "owner": "string",
      "status": "WAITING_UPLOAD",
      "download_url": "https://example.com",
      "download_url_expires_at": "2026-10-13T09:00:00.000Z",
      "duration_ms": 1,
      "aspect_ratio": "string",
      "thumbnail": "https://example.com",
      "captions": "https://example.com",
      "title": "string",
      "used_in_post": "string",
      "processing_failure_reason": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `linkedin-images-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `media_id` (string)
- `url` (string (uri))

```bash
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:

```json
{
  "id": "string",
  "owner": "string",
  "status": "WAITING_UPLOAD",
  "download_url": "https://example.com",
  "download_url_expires_at": "2026-10-13T09:00:00.000Z",
  "duration_ms": 1,
  "aspect_ratio": "string",
  "thumbnail": "https://example.com",
  "captions": "https://example.com",
  "title": "string",
  "used_in_post": "string",
  "processing_failure_reason": "string"
}
```

## 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` · MCP tool: `linkedin-images-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/images/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "owner": "string",
  "status": "WAITING_UPLOAD",
  "download_url": "https://example.com",
  "download_url_expires_at": "2026-10-13T09:00:00.000Z",
  "duration_ms": 1,
  "aspect_ratio": "string",
  "thumbnail": "https://example.com",
  "captions": "https://example.com",
  "title": "string",
  "used_in_post": "string",
  "processing_failure_reason": "string"
}
```

## 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` · MCP tool: `linkedin-videos-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `cursor` (string): Opaque cursor (start offset) from next_cursor
- `limit` (integer; 1–100)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/videos" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "owner": "string",
      "status": "WAITING_UPLOAD",
      "download_url": "https://example.com",
      "download_url_expires_at": "2026-10-13T09:00:00.000Z",
      "duration_ms": 1,
      "aspect_ratio": "string",
      "thumbnail": "https://example.com",
      "captions": "https://example.com",
      "title": "string",
      "used_in_post": "string",
      "processing_failure_reason": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `linkedin-videos-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `media_id` (string)
- `url` (string (uri))
- `title` (string)
- `thumbnail_media_id` (string)
- `captions_media_id` (string): English SRT file

```bash
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:

```json
{
  "id": "string",
  "owner": "string",
  "status": "WAITING_UPLOAD",
  "download_url": "https://example.com",
  "download_url_expires_at": "2026-10-13T09:00:00.000Z",
  "duration_ms": 1,
  "aspect_ratio": "string",
  "thumbnail": "https://example.com",
  "captions": "https://example.com",
  "title": "string",
  "used_in_post": "string",
  "processing_failure_reason": "string"
}
```

## 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` · MCP tool: `linkedin-videos-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/videos/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "owner": "string",
  "status": "WAITING_UPLOAD",
  "download_url": "https://example.com",
  "download_url_expires_at": "2026-10-13T09:00:00.000Z",
  "duration_ms": 1,
  "aspect_ratio": "string",
  "thumbnail": "https://example.com",
  "captions": "https://example.com",
  "title": "string",
  "used_in_post": "string",
  "processing_failure_reason": "string"
}
```

## 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` · MCP tool: `linkedin-documents-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `cursor` (string): Opaque cursor (start offset) from next_cursor
- `limit` (integer; 1–100)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/documents" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "owner": "string",
      "status": "WAITING_UPLOAD",
      "download_url": "https://example.com",
      "download_url_expires_at": "2026-10-13T09:00:00.000Z",
      "duration_ms": 1,
      "aspect_ratio": "string",
      "thumbnail": "https://example.com",
      "captions": "https://example.com",
      "title": "string",
      "used_in_post": "string",
      "processing_failure_reason": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `linkedin-documents-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `media_id` (string)
- `url` (string (uri))
- `title` (string)

```bash
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:

```json
{
  "id": "string",
  "owner": "string",
  "status": "WAITING_UPLOAD",
  "download_url": "https://example.com",
  "download_url_expires_at": "2026-10-13T09:00:00.000Z",
  "duration_ms": 1,
  "aspect_ratio": "string",
  "thumbnail": "https://example.com",
  "captions": "https://example.com",
  "title": "string",
  "used_in_post": "string",
  "processing_failure_reason": "string"
}
```

## 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` · MCP tool: `linkedin-documents-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/documents/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "owner": "string",
  "status": "WAITING_UPLOAD",
  "download_url": "https://example.com",
  "download_url_expires_at": "2026-10-13T09:00:00.000Z",
  "duration_ms": 1,
  "aspect_ratio": "string",
  "thumbnail": "https://example.com",
  "captions": "https://example.com",
  "title": "string",
  "used_in_post": "string",
  "processing_failure_reason": "string"
}
```

## 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` · MCP tool: `linkedin-events-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `lifecycle` (string; one of UPCOMING, ONGOING, PAST)
- `exclude_cancelled` (boolean)
- `entry_criteria` (string; one of PUBLIC, GATED)
- `sort_order` (string; one of START_TIME_ASC, END_TIME_DESC)
- `cursor` (string): Opaque cursor (start offset) from next_cursor
- `limit` (integer; 1–100)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/events" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "urn": "string",
      "name": "string",
      "description": "string",
      "type": "live_video",
      "organizer": "string",
      "starts_at": "2026-10-13T09:00:00.000Z",
      "ends_at": "2026-10-13T09:00:00.000Z",
      "url": "https://example.com",
      "address": {
        "line1": "string",
        "city": "string",
        "geographicArea": "string",
        "postalCode": "string",
        "country": "US"
      },
      "venue_details": "string",
      "vanity_name": "string",
      "discovery_mode": "LISTED",
      "background_image": "string",
      "live_video": "string",
      "ugc_post": "string",
      "created_at": "2026-10-13T09:00:00.000Z",
      "updated_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `linkedin-events-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `name` (string)
- `type` (string; one of live_video, external, in_person)
- `starts_at` (string (date-time))
- `ends_at` (string (date-time))
- `description` (string)
- `url` (string (uri))
- `address` (object)
  - `address.line1` (string)
  - `address.city` (string)
  - `address.geographicArea` (string)
  - `address.postalCode` (string)
  - `address.country` (string)
- `venue_details` (string)
- `vanity_name` (string)
- `discovery_mode` (string; one of LISTED, URL_ONLY)
- `background_image` (string): urn:li:digitalmediaAsset:…
- `privacy_policy_url` (string (uri)): Attach a templated lead gen registration form
- `test_event` (boolean)
- `post` (boolean): Share the event to the feed (required for it to be visible)
- `commentary` (string)

```bash
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:

```json
{
  "id": "string",
  "urn": "string",
  "name": "string",
  "description": "string",
  "type": "live_video",
  "organizer": "string",
  "starts_at": "2026-10-13T09:00:00.000Z",
  "ends_at": "2026-10-13T09:00:00.000Z",
  "url": "https://example.com",
  "address": {
    "line1": "string",
    "city": "string",
    "geographicArea": "string",
    "postalCode": "string",
    "country": "US"
  },
  "venue_details": "string",
  "vanity_name": "string",
  "discovery_mode": "LISTED",
  "background_image": "string",
  "live_video": "string",
  "ugc_post": "string",
  "created_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z"
}
```

## 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` · MCP tool: `linkedin-events-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/events/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "urn": "string",
  "name": "string",
  "description": "string",
  "type": "live_video",
  "organizer": "string",
  "starts_at": "2026-10-13T09:00:00.000Z",
  "ends_at": "2026-10-13T09:00:00.000Z",
  "url": "https://example.com",
  "address": {
    "line1": "string",
    "city": "string",
    "geographicArea": "string",
    "postalCode": "string",
    "country": "US"
  },
  "venue_details": "string",
  "vanity_name": "string",
  "discovery_mode": "LISTED",
  "background_image": "string",
  "live_video": "string",
  "ugc_post": "string",
  "created_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z"
}
```

## 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` · MCP tool: `linkedin-events-update`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Body

- `name` (string)
- `type` (string; one of live_video, external, in_person)
- `starts_at` (string (date-time))
- `ends_at` (string (date-time))
- `description` (string)
- `url` (string (uri))
- `address` (object)
  - `address.line1` (string)
  - `address.city` (string)
  - `address.geographicArea` (string)
  - `address.postalCode` (string)
  - `address.country` (string)
- `venue_details` (string)
- `vanity_name` (string)
- `discovery_mode` (string; one of LISTED, URL_ONLY)
- `background_image` (string): urn:li:digitalmediaAsset:…
- `privacy_policy_url` (string (uri)): Attach a templated lead gen registration form
- `test_event` (boolean)
- `post` (boolean): Share the event to the feed (required for it to be visible)
- `commentary` (string)

```bash
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:

```json
{
  "id": "string",
  "urn": "string",
  "name": "string",
  "description": "string",
  "type": "live_video",
  "organizer": "string",
  "starts_at": "2026-10-13T09:00:00.000Z",
  "ends_at": "2026-10-13T09:00:00.000Z",
  "url": "https://example.com",
  "address": {
    "line1": "string",
    "city": "string",
    "geographicArea": "string",
    "postalCode": "string",
    "country": "US"
  },
  "venue_details": "string",
  "vanity_name": "string",
  "discovery_mode": "LISTED",
  "background_image": "string",
  "live_video": "string",
  "ugc_post": "string",
  "created_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z"
}
```

## 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` · MCP tool: `linkedin-events-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/events/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## 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: `write` · MCP tool: `linkedin-events-post`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `commentary` (string)
- `type` (string; one of live_video, external, in_person)
- `live_video` (string)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `read` · MCP tool: `linkedin-comments-list` · Zernio: `GET /v1/inbox/comments`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `post_id` (string): Post URN (share / ugcPost / activity)
- `comment_id` (string): List replies of this comment URN instead
- `cursor` (string): Opaque cursor (start offset) from next_cursor
- `limit` (integer; 1–100)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/comments" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "text": "string",
      "author": "string",
      "author_type": "person",
      "agent": "string",
      "created_at": "2026-10-13T09:00:00.000Z",
      "updated_at": "2026-10-13T09:00:00.000Z",
      "edited": true,
      "like_count": 1,
      "liked_by_me": true,
      "reply_count": 1,
      "comment_id": "string",
      "post_id": "string",
      "parent_id": "string",
      "is_own": true,
      "attachments": [
        {
          "type": "string",
          "urn": "string",
          "url": "https://example.com"
        }
      ],
      "mentions": [
        {
          "start": 1,
          "length": 1,
          "urn": "string"
        }
      ]
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `linkedin-comments-create` · Zernio: `POST /v1/inbox/comments/{postId}`, `POST /v1/inbox/comments/{postId}/{commentId}/like`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `post_id` (string)
- `parent_comment_id` (string): Reply to this comment URN
- `text` (string; required; ≤ 1250 characters)
- `image_media_id` (string)
- `mentions` (array of object)
  - `mentions[].start` (integer)
  - `mentions[].length` (integer)
  - `mentions[].urn` (string)

```bash
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:

```json
{
  "id": "string",
  "text": "string",
  "author": "string",
  "author_type": "person",
  "agent": "string",
  "created_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z",
  "edited": true,
  "like_count": 1,
  "liked_by_me": true,
  "reply_count": 1,
  "comment_id": "string",
  "post_id": "string",
  "parent_id": "string",
  "is_own": true,
  "attachments": [
    {
      "type": "string",
      "urn": "string",
      "url": "https://example.com"
    }
  ],
  "mentions": [
    {
      "start": 1,
      "length": 1,
      "urn": "string"
    }
  ]
}
```

## 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: `read` · MCP tool: `linkedin-comments-get` · Zernio: `GET /v1/inbox/comments/{postId}`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/comments/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "text": "string",
  "author": "string",
  "author_type": "person",
  "agent": "string",
  "created_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z",
  "edited": true,
  "like_count": 1,
  "liked_by_me": true,
  "reply_count": 1,
  "comment_id": "string",
  "post_id": "string",
  "parent_id": "string",
  "is_own": true,
  "attachments": [
    {
      "type": "string",
      "urn": "string",
      "url": "https://example.com"
    }
  ],
  "mentions": [
    {
      "start": 1,
      "length": 1,
      "urn": "string"
    }
  ]
}
```

## 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: `write` · MCP tool: `linkedin-comments-update` · Zernio: `PATCH /v1/inbox/comments/{postId}/{commentId}`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Body

- `text` (string; required; ≤ 1250 characters)

```bash
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:

```json
{
  "id": "string",
  "text": "string",
  "author": "string",
  "author_type": "person",
  "agent": "string",
  "created_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z",
  "edited": true,
  "like_count": 1,
  "liked_by_me": true,
  "reply_count": 1,
  "comment_id": "string",
  "post_id": "string",
  "parent_id": "string",
  "is_own": true,
  "attachments": [
    {
      "type": "string",
      "urn": "string",
      "url": "https://example.com"
    }
  ],
  "mentions": [
    {
      "start": 1,
      "length": 1,
      "urn": "string"
    }
  ]
}
```

## 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: `write` · MCP tool: `linkedin-comments-delete` · Zernio: `DELETE /v1/inbox/comments/{postId}`, `DELETE /v1/inbox/comments/{postId}/{commentId}/like`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/comments/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## 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: `write` · MCP tool: `linkedin-comments-like`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `reaction_type` (string; one of LIKE, PRAISE, EMPATHY, INTEREST, APPRECIATION, ENTERTAINMENT)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `linkedin-comments-unlike`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `linkedin-comments-reply`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `text` (string; required; ≤ 1250 characters)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `read` · MCP tool: `linkedin-reactions-list` · Zernio: `GET /v1/accounts/{accountId}/linkedin-post-reactions`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `entity` (string; required): Post or comment URN
- `sort` (string; one of REVERSE_CHRONOLOGICAL, CHRONOLOGICAL, RELEVANCE)
- `cursor` (string): Opaque cursor (start offset) from next_cursor
- `limit` (integer; 1–100)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/reactions?entity=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "reaction_type": "LIKE",
      "actor": "string",
      "actor_type": "person",
      "root": "string",
      "created_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `linkedin-reactions-create` · Zernio: `POST /v1/inbox/posts/{postId}/like`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `entity` (string; required)
- `reaction_type` (string; one of LIKE, PRAISE, EMPATHY, INTEREST, APPRECIATION, ENTERTAINMENT)

```bash
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:

```json
{
  "id": "string",
  "reaction_type": "LIKE",
  "actor": "string",
  "actor_type": "person",
  "root": "string",
  "created_at": "2026-10-13T09:00:00.000Z"
}
```

## 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: `write` · MCP tool: `linkedin-reactions-delete` · Zernio: `DELETE /v1/inbox/posts/{postId}/like`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/reactions/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## 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: `write` · MCP tool: `linkedin-reactions-summary`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `entity` (string; required)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `read` · MCP tool: `linkedin-mentions-list` · Zernio: `GET /v1/inbox/mentions`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `since` (string (date-time))
- `until` (string (date-time))
- `cursor` (string): Opaque cursor (start offset) from next_cursor
- `limit` (integer; 1–100)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/mentions" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "type": "mention",
      "kind": "post",
      "post_id": "string",
      "comment_id": "string",
      "author": "string",
      "text": "string",
      "organization": "string",
      "created_at": "2026-10-13T09:00:00.000Z",
      "url": "https://example.com"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `linkedin-mentions-reply` · Zernio: `POST /v1/inbox/mentions/reply`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `post_id` (string)
- `comment_id` (string)
- `message` (string; required; ≤ 1250 characters)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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` · MCP tool: `linkedin-notifications-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `actions` (array of string)
- `source_post` (string)
- `since` (string (date-time))
- `until` (string (date-time))
- `cursor` (string): Opaque cursor (start offset) from next_cursor
- `limit` (integer; 1–100)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/notifications" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "action": "LIKE",
      "kind": "post",
      "organization": "string",
      "source_post": "string",
      "generated_activity": "string",
      "author": "string",
      "text": "string",
      "created_at": "2026-10-13T09:00:00.000Z",
      "url": "https://example.com"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `read` · MCP tool: `linkedin-mention-search-list` · Zernio: `GET /v1/accounts/{accountId}/linkedin-mentions`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `keywords` (string; required; ≥ 3 characters)
- `organization_urn` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/mention-search?keywords=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "urn": "string",
      "name": "string",
      "first_name": "string",
      "last_name": "string",
      "headline": "string",
      "photo_urn": "string",
      "mention_format": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `linkedin-mention-search-resolve`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `url` (string; required)
- `display_name` (string)
- `organization_urn` (string)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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` · MCP tool: `linkedin-insights-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `since` (string (date)): Inclusive start date (YYYY-MM-DD)
- `until` (string (date)): Inclusive end date (YYYY-MM-DD)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/insights" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "series": [
    {
      "date": "2026-10-13"
    }
  ],
  "totals": {
    "key": 1.5
  }
}
```

## 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` · MCP tool: `linkedin-followers-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `since` (string (date)): Inclusive start date (YYYY-MM-DD)
- `until` (string (date)): Inclusive end date (YYYY-MM-DD)
- `granularity` (string; one of DAY, WEEK, MONTH)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/followers" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "total": 1,
  "granularity": "DAY",
  "series": [
    {
      "date": "2026-10-13",
      "organic": 1,
      "paid": 1,
      "total": 1,
      "value": 1
    }
  ]
}
```

## 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` · MCP tool: `linkedin-demographics-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/demographics" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "countries": [
    {
      "key": "string",
      "value": 1
    }
  ],
  "regions": [
    {
      "key": "string",
      "value": 1
    }
  ],
  "seniorities": [
    {
      "key": "string",
      "value": 1
    }
  ],
  "industries": [
    {
      "key": "string",
      "value": 1
    }
  ],
  "functions": [
    {
      "key": "string",
      "value": 1
    }
  ],
  "company_sizes": [
    {
      "key": "string",
      "value": 1
    }
  ],
  "association_types": [
    {
      "key": "string",
      "value": 1
    }
  ]
}
```

## 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` · MCP tool: `linkedin-page-statistics-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `since` (string (date)): Inclusive start date (YYYY-MM-DD)
- `until` (string (date)): Inclusive end date (YYYY-MM-DD)
- `granularity` (string; one of DAY, MONTH)
- `brand` (string): urn:li:organizationBrand:… (showcase page)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/page-statistics" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "totals": {
    "key": 1.5
  },
  "series": [
    {
      "date": "2026-10-13"
    }
  ],
  "countries": [
    {
      "key": "string",
      "value": 1
    }
  ],
  "regions": [
    {
      "key": "string",
      "value": 1
    }
  ],
  "seniorities": [
    {
      "key": "string",
      "value": 1
    }
  ],
  "industries": [
    {
      "key": "string",
      "value": 1
    }
  ],
  "functions": [
    {
      "key": "string",
      "value": 1
    }
  ],
  "company_sizes": [
    {
      "key": "string",
      "value": 1
    }
  ]
}
```

## 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` · MCP tool: `linkedin-share-statistics-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `since` (string (date)): Inclusive start date (YYYY-MM-DD)
- `until` (string (date)): Inclusive end date (YYYY-MM-DD)
- `granularity` (string; one of DAY, MONTH)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/share-statistics" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "lifetime": {
    "key": 1.5
  },
  "series": [
    {
      "date": "2026-10-13"
    }
  ]
}
```

## 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` · MCP tool: `linkedin-post-analytics-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/post-analytics/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "external_id": "string",
  "impressions": 1,
  "reach": 1,
  "likes": 1,
  "comments": 1,
  "shares": 1,
  "clicks": 1,
  "saves": 1,
  "views": 1,
  "engagements": 1,
  "engagement_rate": 1.5
}
```

## 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` · MCP tool: `linkedin-video-analytics-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `post_id` (string; required)
- `since` (string (date)): Inclusive start date (YYYY-MM-DD)
- `until` (string (date)): Inclusive end date (YYYY-MM-DD)
- `aggregation` (string; one of ALL, DAY, WEEK)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/video-analytics?post_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "post_id": "string",
  "rows": [
    {
      "type": "string",
      "date": "string",
      "value": 1.5
    }
  ]
}
```

## 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` · MCP tool: `linkedin-member-post-analytics-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `post_id` (string)
- `metrics` (array of string)
- `aggregation` (string; one of TOTAL, DAILY)
- `since` (string (date)): Inclusive start date (YYYY-MM-DD)
- `until` (string (date)): Inclusive end date (YYYY-MM-DD)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/member-post-analytics" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "rows": [
    {
      "metric": "IMPRESSION",
      "date": "string",
      "value": 1.5
    }
  ]
}
```

## 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: `read` · MCP tool: `linkedin-org-aggregate-get` · Zernio: `GET /v1/analytics/linkedin/org-aggregate-analytics`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `metrics` (array of string)
- `metric_type` (string; one of time_series, total_value)
- `since` (string (date)): Inclusive start date (YYYY-MM-DD)
- `until` (string (date)): Inclusive end date (YYYY-MM-DD)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/org-aggregate" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "dateRange": {
    "since": "string",
    "until": "string"
  },
  "metricType": "time_series",
  "metrics": {
    "key": {
      "total": 1.5,
      "values": [
        {
          "date": "string",
          "value": 1.5
        }
      ]
    }
  },
  "unavailableMetrics": [
    "string"
  ]
}
```

## 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: `read` · MCP tool: `linkedin-member-aggregate-get` · Zernio: `GET /v1/accounts/{accountId}/linkedin-aggregate-analytics`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `aggregation` (string; one of TOTAL, DAILY)
- `metrics` (array of string)
- `since` (string (date)): Inclusive start date (YYYY-MM-DD)
- `until` (string (date)): Inclusive end date (YYYY-MM-DD)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/member-aggregate" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "aggregation": "TOTAL",
  "analytics": {},
  "skippedMetrics": [
    "string"
  ]
}
```

## 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` · MCP tool: `linkedin-webhook-subscriptions-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/webhook-subscriptions" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "organization": "string",
      "user": "string",
      "event_type": "ORGANIZATION_SOCIAL_ACTION_NOTIFICATIONS",
      "webhook": "https://example.com",
      "expires_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `linkedin-webhook-subscriptions-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `webhook_url` (string (uri); required)
- `organization_urn` (string)
- `developer_app_id` (string): Defaults to LINKEDIN_ORG_APP_ID

```bash
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:

```json
{
  "id": "string",
  "organization": "string",
  "user": "string",
  "event_type": "ORGANIZATION_SOCIAL_ACTION_NOTIFICATIONS",
  "webhook": "https://example.com",
  "expires_at": "2026-10-13T09:00:00.000Z"
}
```

## 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` · MCP tool: `linkedin-webhook-subscriptions-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/webhook-subscriptions/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## 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: `write` · MCP tool: `linkedin-targeting-estimate-audience`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `countries` (array of string)
- `geoLocations` (array of string)
- `industries` (array of string)
- `jobFunctions` (array of string)
- `seniorities` (array of string)
- `staffCountRanges` (array of string)
- `degrees` (array of string)
- `fieldsOfStudy` (array of string)
- `organizations` (array of string)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```


---

Source: https://socialit.com/docs/api-reference/focus-linkedin/
