Extract LinkedIn Profile Handle
Resolve a Sales Navigator profile URL or ACo/ACw/ACr identifier to the public LinkedIn handle, people ID, and matching profile URLs.
/v1/actions/linkedin-extract-linkedin-profile-handle/run/liveEdges is not related to LinkedIn and is not an official LinkedIn product.
Input
Input parameters
A Sales Navigator Profile URL should start with 'https://www.linkedin.com/sales/people/' or 'https://www.linkedin.com/sales/lead/'
A sales_navigator_profile_id should start with 'ACo', 'ACw' or 'ACr'
Integration
Array of identity UUIDs to use for the action
Mode for identity handling: direct, auto, or managed.
Description
What Extract LinkedIn Profile Handle does
Extract LinkedIn Profile Handle converts a Sales Navigator profile URL or ACo/ACw/ACr identifier into the public LinkedIn handle, people ID, and both profile URLs. You get a canonical identity set that downstream LinkedIn actions, CRM joins, and dedupe logic can rely on.
The action runs on the LinkedIn level and is the richer sibling of Peopleid From Salesnavigatorid — it returns the full URL/handle set, not only the numeric people ID.
How it works
You pass a Sales Navigator profile URL or sales_navigator_profile_id. Edges resolves the mapping through your authenticated LinkedIn session and returns linkedin_profile_handle, linkedin_profile_id, linkedin_profile_url, and the matching Sales Navigator URL and ID.
The operation runs live. If the identifier is malformed or the profile cannot be resolved, Edges returns a typed error so the workflow can branch instead of writing a bad join key.
When to use Extract LinkedIn Profile Handle
Use this when a pipeline starts on Sales Navigator identifiers and later needs public LinkedIn URLs or /in/ handles — warehouse joins, LinkedIn-first enrichment, or links you can share outside SN.
Most teams call it once per SN lead, cache the result on sales_navigator_profile_id, and reuse the handle for linkedin-extract-people and messaging actions.
Use cases
- Unify SN search results with LinkedIn-first CRM records by writing both IDs and URLs on the same contact.
- Turn a Sales Navigator lead URL into a public linkedin.com/in/ link for outreach copy or a human review queue.
- Feed linkedin-extract-people, visit, or connect actions that prefer a LinkedIn handle over an ACo identifier.
- Dedupe mixed SN and LinkedIn lists on a single people ID.
Best practices
- Cache by sales_navigator_profile_id. Handles rarely change; do not re-resolve on every search page.
- Prefer this action over Peopleid From Salesnavigatorid when you also need URLs or the /in/ handle.
- Validate the ACo/ACw/ACr prefix before calling. Bad IDs fail fast with a typed error.
- Chain into linkedin-extract-people only when you need the full public profile payload, not just the identifier map.
Common questions
What do I pass in?
A Sales Navigator people or lead URL, or a sales_navigator_profile_id that starts with ACo, ACw, or ACr.
Does this return the full profile?
No. It returns identifiers and URLs only. Use Extract Sales Navigator Profile or Extract LinkedIn Profile for the person record.
How is this different from Peopleid From Salesnavigatorid?
That action returns only linkedin_profile_id. This one returns the handle plus both LinkedIn and Sales Navigator URLs and IDs.
Get started
Call Extract LinkedIn Profile Handle after a Sales Navigator search or list extract, store the mapped IDs, then compose with Extract LinkedIn Profile or messaging actions from the library.
// Related
Other ways to work with People.
Try it with 100 free credits.
No card. Copy the snippet, paste your key, hit enter.