nv.openPersonPage
This action allows you to open a person page in Sales Navigator to retrieve their basic information and perform additional person-related actions if needed.
Constraints
⏺️
Root Start: allowed, when
personHashedUrl parameter is provided.⬆️
Parent Actions: nv.doForPeople, st.openPersonPage.
⬇️
Parameters
{
"actionType": "nv.openPersonPage",
"label": "person1",
"personHashedUrl": "https://www.linkedin.com/in/SInQBmjJ015eLr8",
"basicInfo": true,
"then": { ... }
}
label(optional) – custom label for tracking this action in workflow completion.personHashedUrl(required for root start, forbidden for parent start) – hashed LinkedIn URL of the person.basicInfo(optional, default:false) – when set totrue, the action includes basic person information in the results.then(optional) – object or array of child actions to be executed within this action.
Result options
- Successful page opening with
basicInfoset totrue:
{
"actionType": "nv.openPersonPage",
"label": "person1",
"success": true,
"data": {
"name": "John Doe",
"publicUrl": "https://www.linkedin.com/in/person1",
"hashedUrl": "https://www.linkedin.com/in/SInQBmjJ015eLr8",
"headline": "Software Engineer at TechCorp",
"location": "San Francisco, USA",
"countryCode": "US",
"position": "Software Engineer",
"companyName": "TechCorp",
"companyHashedUrl": "https://www.linkedin.com/company/12345678",
"then": { ... }
}
}
label– included only if specified in the action parameters.data– basic information about the person and results of child actions execution.name– full name of the person.publicUrl– public LinkedIn URL of the person.hashedUrl– hashed LinkedIn URL of the person.headline– headline of the person.location– free-form string indicating the person's location.countryCode– two-character code of the person's country.position– current job position of the person.companyName– name of the person's current company.companyHashedUrl– hashed LinkedIn URL of the person's current company.
then– results of child actions execution.
- Successful page opening with
basicInfoset tofalse:
{
"actionType": "nv.openPersonPage",
"label": "person1",
"success": true,
"data": {
"then": { ... }
}
}
label– included only if specified in the action parameters.data.then– results of child actions execution.
- Failed page opening:
{
"actionType": "nv.openPersonPage",
"label": "person1",
"success": false,
"error": {
"type": "personNotFound",
"message": "The provided URL is not an existing LinkedIn person."
}
}
label– included only if specified in the action parameters.error.type– enum with the following possible values:noSalesNavigator– your account does not have Sales Navigator subscription.personNotFound– provided URL is not an existing LinkedIn person.