nv.openCompanyPage

This action allows you to open a company page in Sales Navigator to retrieve its basic information and perform additional company-related actions if needed.

Constraints

Paramenters

{
  "actionType": "nv.openCompanyPage",
  "label": "company1",
  "companyHashedUrl": "https://www.linkedin.com/company/12345678",
  "basicInfo": true,
  "then": { ... }
}

• label (optional) – custom label for tracking this action in workflow completion.
• companyHashedUrl (required for root start, forbidden for parent start) – hashed LinkedIn URL of the company.
• basicInfo (optional, default: false) – when set to true, the action includes basic company 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.openCompanyPage",
  "label": "company1",
  "success": true,
  "data": {
    "name": "TechCorp",
    "publicUrl": "https://www.linkedin.com/company/company1",
    "description": "TechCorp is a leading provider of innovative technology solutions for businesses worldwide.",
    "location": "Cupertino, California",
    "headquarters": "US",
    "industry": "Information Technology",
    "website": "https://techcorp.com",
    "employeeCount": 500,
    "yearFounded": 2019,
    "then": { ... }
  }
}

• label – included only if specified in the action parameters.
• data – basic information about the company and results of child actions execution.
  • name – name of the company.
  • publicUrl – public LinkedIn URL of the company.
  • description – description of the company.
  • location – free-form string representing the company headquarters location.
  • headquarters – two-character country code (e.g., "US", "UK") representing headquarters location.
  • industry – enum representing the company industry. Takes specific values available in the LinkedIn interface.
• website – company's official website URL.
• employeeCount – total number of employees associated with the company.
• yearFounded – year the company was established, if available.
• then – results of child actions execution.

2. Successful page opening with basicInfo set to false:

{
  "actionType": "nv.openCompanyPage",
  "label": "company1",
  "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.openCompanyPage",
  "label": "company1",
  "success": false,
  "error": {
    "type": "companyNotFound",
    "message": "The provided URL is not an existing LinkedIn company."
  }
}

• 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.
  • companyNotFound – provided URL is not an existing LinkedIn company.
  • openingNotAllowed – LinkedIn has blocked opening this company page due to exceeding limits, privacy settings, or other restrictions.