The tag form
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 theid 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 with a name, or a company’s LinkedIn link or the short name in that link. The key needsaccounts: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.
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_searchisneeds_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.
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.titleif 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
textis 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\_Doecounts 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 thefind-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.