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

# Tag people and companies on LinkedIn

> Write @mentions that LinkedIn turns into real tags, through the API or MCP

A plain "@Jane Doe" in a LinkedIn post sent through the API shows up as plain text. LinkedIn only tags someone when the post holds a tag in LinkedIn's own form, with LinkedIn's ID for that person or company. This guide shows how to find that tag and put it in a post.

## The tag form

```text theme={null}
@[Jane Doe](urn:li:person:A1b2C3d4E5)
@[Acme](urn:li:organization:2414183)
```

The name goes in square brackets and LinkedIn's ID in round brackets. The ID is `urn:li:person:…` for a person, `urn:li:organization:…` for a company or school, or `urn:li:organizationBrand:…` for a brand page.

The name must match LinkedIn's exactly, upper and lower case included: a company's full name, or a person's first, last or full name. If it doesn't match, LinkedIn shows the name as plain text instead of a tag.

A person's LinkedIn ID isn't in their profile link, so you can't write a person's tag from it. Use the search below: it gives you the whole tag, ready to paste, for people and companies alike (for a company, the search takes its LinkedIn link).

## 1. Pick the LinkedIn account

[List Accounts](https://docs.postsyncer.com/api-reference/accounts/list.md) and take the `id` of the LinkedIn account the post goes out from (`platform` is `linkedin`). Search with that account: what you can find, and the ID a person gets, depend on it.

## 2. Search

Call [Find LinkedIn Mentions](https://docs.postsyncer.com/api-reference/accounts/linkedin-mentions.md) with a name, or a company's LinkedIn link or the short name in that link. The key needs `accounts:read`.

```bash theme={null}
curl -G "https://postsyncer.com/api/v1/accounts/245/linkedin/mentions" \
  --data-urlencode "q=jane" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
```

```json theme={null}
{
  "mentions": [
    {
      "type": "person",
      "urn": "urn:li:person:A1b2C3d4E5",
      "name": "Jane Doe",
      "vanity_name": null,
      "headline": null,
      "picture": null,
      "source": "tagged_before",
      "text": "@[Jane Doe](urn:li:person:A1b2C3d4E5)"
    }
  ],
  "people_search": "available"
}
```

## 3. Put `text` in the post

Paste a result's `text` where the name should go, exactly as it is. Its name is already escaped for LinkedIn. Write the rest of the text as usual: PostSyncer escapes it for LinkedIn when it sends the post.

```bash theme={null}
curl -X POST "https://postsyncer.com/api/v1/posts" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "workspace_id": 12,
    "content": [
      { "text": "Great talk today with @[Jane Doe](urn:li:person:A1b2C3d4E5) at @[Acme](urn:li:organization:2414183)!" }
    ],
    "schedule_type": "publish_now",
    "accounts": [{ "id": 245 }]
  }'
```

A tag works in `content[].text` and in the account's own LinkedIn text, `accounts[].settings.title`.

## Who can be tagged

LinkedIn's API has no search of all its members, so the search finds:

* **Any company or school**, by its LinkedIn link (`linkedin.com/company/acme`) or the short name in that link (`acme`).
* **People who follow the account's Page.** For a personal profile, people who follow the Pages its owner runs. If `people_search` is `needs_reconnect`, the account was connected through PostSyncer's older LinkedIn connection: reconnect it in PostSyncer to search its followers.
* **Your teammates:** people whose LinkedIn profiles are connected in the same workspace.
* **People and companies tagged before** in this workspace: in posts PostSyncer brought in from LinkedIn, or in posts that tag someone found with the @ search in the PostSyncer app. The API and MCP search only reads: what it finds isn't remembered.

Someone outside these can't be found.

## Good to know

* **Other networks get the name.** When the same post also goes to X, Facebook, Threads or any other network, each tag goes out as just the name: "Great talk today with Jane Doe at Acme!". No "@" is added, so it can't tag a different account by mistake.

* **First comments don't tag.** LinkedIn comments don't read tags, so a tag in a first comment (`is_first_comment`) goes out as the name.

* **Several LinkedIn accounts.** A company tag works from every account. A person found with one LinkedIn account may not work from another. Search with each account, and give each one its own text in `accounts[].settings.title` if they need different tags.

* **A tag that can't work goes out as the name.** If a person can't be tagged from the account the post goes out from, PostSyncer sends their name as plain text and the post still publishes. That account's entry in [Get Post](https://docs.postsyncer.com/api-reference/posts/get.md) (`platforms[].notes`) then says so:

  ```json theme={null}
  {
    "type": "mentions_untagged",
    "message": "Jane Doe could not be tagged from this account, so the name went out as plain text."
  }
  ```

* **Writing a tag yourself.** You can, but pasting `text` is safer. The name can't hold `[`, `]` or a line break, and it can be up to 200 characters as written in the tag, escapes included (`Jane\_Doe` counts as 9). A name with `(`, `_` or other special characters can be written plain or escaped: PostSyncer escapes it once either way.

* **Reading posts back.** The API and webhooks return the text as you saved it, tags included. The PostSyncer app shows the name.

## With MCP

AI assistants use the `find-linkedin-mentions` tool with `account_id` and `query`. It returns the same answer as the API and needs the same `accounts:read` permission. Then they put a result's `text` into `create-post` or `update-post`. See the [MCP tools reference](https://docs.postsyncer.com/mcp/tools-reference.md#accounts).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.