Skip to main content
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

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 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. Call Find LinkedIn Mentions with a name, or a company’s LinkedIn link or the short name in that link. The key needs accounts:read.

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.
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 (platforms[].notes) then says so:
  • 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.