> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pinkfish.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# linkedin

> Profile, posts, and connections

**Server path:** `/linkedin` | **Type:** Application | **PCID required:** Yes

## Tools

| Tool                                                              | Description                                                                                                                                                                                |
| ----------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| [`linkedin_get_user_info`](#linkedin_get_user_info)               | Get authenticated user information from LinkedIn                                                                                                                                           |
| [`linkedin_share_post`](#linkedin_share_post)                     | Share a post on LinkedIn - supports text-only posts, posts with a link/article, or posts with an uploaded image                                                                            |
| [`linkedin_search_organizations`](#linkedin_search_organizations) | Search for a LinkedIn organization by vanity name (the URL slug). Returns the organization ID (URN) and basic details. Use this to find the organization URN needed for mentions in posts. |
| [`linkedin_like_post`](#linkedin_like_post)                       | Like a LinkedIn post                                                                                                                                                                       |
| [`linkedin_comment_on_post`](#linkedin_comment_on_post)           | Comment on a LinkedIn post                                                                                                                                                                 |

***

## linkedin\_get\_user\_info

Get authenticated user information from LinkedIn

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID"
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## linkedin\_share\_post

Share a post on LinkedIn - supports text-only posts, posts with a link/article, or posts with an uploaded image

**Parameters:**

| Parameter        | Type      | Required | Default       | Description                                                                                                                                                                                              |
| ---------------- | --------- | -------- | ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `author`         | string    | Yes      | —             | Author URN (e.g., urn:li:person:XXXXXX)                                                                                                                                                                  |
| `text`           | string    | Yes      | —             | Post text content or commentary. When using mentions, the organization name must appear in the text at the specified start/length position.                                                              |
| `url`            | string    | No       | —             | Optional URL of the link/article to share. Creates an article post. Cannot be combined with imageUrl                                                                                                     |
| `imageUrl`       | string    | No       | —             | Optional URL of an image to upload and attach to the post. Creates an image post. Cannot be combined with url                                                                                            |
| `title`          | string    | No       | —             | Title for the shared link (only used when url is provided)                                                                                                                                               |
| `description`    | string    | No       | —             | Description for the shared link (only used when url is provided)                                                                                                                                         |
| `lifecycleState` | string    | No       | `"PUBLISHED"` | Post lifecycle state                                                                                                                                                                                     |
| `visibility`     | string    | No       | `"PUBLIC"`    | Post visibility setting                                                                                                                                                                                  |
| `mentions`       | object\[] | No       | —             | Optional array of entity mentions to tag in the post. The name must appear in the text — the tool will automatically find its position. Use linkedin\_search\_organizations to get the organization URN. |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID"
      },
      "author": {
        "type": "string",
        "description": "Author URN (e.g., urn:li:person:XXXXXX)"
      },
      "text": {
        "type": "string",
        "description": "Post text content or commentary. When using mentions, the organization name must appear in the text at the specified start/length position."
      },
      "url": {
        "type": "string",
        "description": "Optional URL of the link/article to share. Creates an article post. Cannot be combined with imageUrl"
      },
      "imageUrl": {
        "type": "string",
        "description": "Optional URL of an image to upload and attach to the post. Creates an image post. Cannot be combined with url"
      },
      "title": {
        "type": "string",
        "description": "Title for the shared link (only used when url is provided)"
      },
      "description": {
        "type": "string",
        "description": "Description for the shared link (only used when url is provided)"
      },
      "lifecycleState": {
        "type": "string",
        "enum": [
          "PUBLISHED",
          "DRAFT"
        ],
        "default": "PUBLISHED",
        "description": "Post lifecycle state"
      },
      "visibility": {
        "type": "string",
        "enum": [
          "PUBLIC",
          "CONNECTIONS",
          "LOGGED_IN"
        ],
        "default": "PUBLIC",
        "description": "Post visibility setting"
      },
      "mentions": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "name": {
              "type": "string",
              "description": "The exact name of the entity as it appears in the post text (e.g., \"Slack\"). Must match a substring in the text."
            },
            "urn": {
              "type": "string",
              "description": "URN of the entity to mention (e.g., urn:li:organization:221390). Use linkedin_search_organizations to find organization URNs."
            }
          }
        },
        "description": "Optional array of entity mentions to tag in the post. The name must appear in the text — the tool will automatically find its position. Use linkedin_search_organizations to get the organization URN."
      }
    },
    "required": [
      "PCID",
      "author",
      "text"
    ]
  }
  ```
</Expandable>

***

## linkedin\_search\_organizations

Search for a LinkedIn organization by vanity name (the URL slug). Returns the organization ID (URN) and basic details. Use this to find the organization URN needed for mentions in posts.

**Parameters:**

| Parameter    | Type   | Required | Default | Description                                                     |
| ------------ | ------ | -------- | ------- | --------------------------------------------------------------- |
| `vanityName` | string | Yes      | —       | The organization vanity name (URL slug, e.g., "activecampaign") |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID"
      },
      "vanityName": {
        "type": "string",
        "description": "The organization vanity name (URL slug, e.g., \"activecampaign\")"
      }
    },
    "required": [
      "PCID",
      "vanityName"
    ]
  }
  ```
</Expandable>

***

## linkedin\_like\_post

Like a LinkedIn post

**Parameters:**

| Parameter      | Type   | Required | Default  | Description                                                |
| -------------- | ------ | -------- | -------- | ---------------------------------------------------------- |
| `post_id`      | string | Yes      | —        | LinkedIn post URN (e.g., urn:li:share:7418926746684747777) |
| `actor`        | string | Yes      | —        | Actor URN (e.g., urn:li:person:XXXXXX)                     |
| `reactionType` | string | No       | `"LIKE"` | Type of reaction to give                                   |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID"
      },
      "post_id": {
        "type": "string",
        "description": "LinkedIn post URN (e.g., urn:li:share:7418926746684747777)"
      },
      "actor": {
        "type": "string",
        "description": "Actor URN (e.g., urn:li:person:XXXXXX)"
      },
      "reactionType": {
        "type": "string",
        "enum": [
          "LIKE",
          "PRAISE",
          "APPRECIATION",
          "EMPATHY",
          "INTEREST",
          "ENTERTAINMENT"
        ],
        "default": "LIKE",
        "description": "Type of reaction to give"
      }
    },
    "required": [
      "PCID",
      "post_id",
      "actor"
    ]
  }
  ```
</Expandable>

***

## linkedin\_comment\_on\_post

Comment on a LinkedIn post

**Parameters:**

| Parameter | Type   | Required | Default | Description                                                              |
| --------- | ------ | -------- | ------- | ------------------------------------------------------------------------ |
| `post_id` | string | Yes      | —       | LinkedIn post URN to comment on (e.g., urn:li:share:7418926746684747777) |
| `actor`   | string | Yes      | —       | Actor URN (e.g., urn:li:person:XXXXXX)                                   |
| `text`    | string | Yes      | —       | Comment text content                                                     |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID"
      },
      "post_id": {
        "type": "string",
        "description": "LinkedIn post URN to comment on (e.g., urn:li:share:7418926746684747777)"
      },
      "actor": {
        "type": "string",
        "description": "Actor URN (e.g., urn:li:person:XXXXXX)"
      },
      "text": {
        "type": "string",
        "description": "Comment text content"
      }
    },
    "required": [
      "PCID",
      "post_id",
      "actor",
      "text"
    ]
  }
  ```
</Expandable>