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

Paramenters

{
  "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 to true, 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

1. Successful page opening with basicInfo set to true:

{
  "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.

2. Successful page opening with basicInfo set to false:

{
  "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.

3. 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.
  • openingNotAllowed – LinkedIn has blocked opening this person page due to exceeding limits, privacy settings, or other restrictions.