Skip to main content

Actions

nv.retrieveCompanyDMs

This action allows you to retrieve company decision makers from Sales Navigator and perform additional person-related actions if needed.

Decision makers are ranked by seniority, starting with the highest-level positions. For example, founders and C-level executives are returned first, followed by VPs, directors, and so on.

Constraints

⏺️
Root Start: not allowed.
⬆️
Parent Actions: nv.openCompanyPage.
⬇️
Child Actions: nv.doForPeople.

Paramenters


{
  "actionType": "nv.retrieveCompanyDMs",
  "label": "company1DMs",
  "limit": 3,
  "then": { ... }
}
  • label (optional) – custom label for tracking this action in workflow completion.
  • limit (optional) – maximum number of decision makers to retrieve. Defaults to 20, with a maximum value of 20. If a company has fewer decision makers than specified, only the available ones will be returned.
  • then (optional) – object or array of child actions to be executed within this action.

Result options

  1. Successful retrieval:

{
  "actionType": "nv.retrieveCompanyDMs",
  "label": "company1DMs",
  "success": true,
  "data": [
    {
      "name": "John Doe",
      "hashedUrl": "https://www.linkedin.com/in/SInQBmjJ015eLr8OeJoj0mrkxx7Jiuy0",
      "position": "Founder",
      "location": "New York, USA",
      "countryCode": "US",
      "then": { ... }
    },
    {
      "name": "Jane Smith",
      "hashedUrl": "https://www.linkedin.com/in/ACoAA2DdsSV83B48UDvgO5jPoу3Gho0o",
      "position": "CEO",
      "location": "San Francisco, USA",
      "countryCode": "US",
      "then": { ... }
    }
  ]
}
  • label – included only if specified in the action parameters.
  • data – array of decision makers with results of child actions execution.
    • name – full name of the decision-maker.
    • hashedUrl – hashed LinkedIn URL of the decision-maker.
    • position – job position of the decision-maker.
    • location – free-form string indicating the decision-maker's location.
    • countryCode – two-character code of the decision-maker's country.
    • then – results of child actions execution.
  1. Failed retrieval:

{
  "actionType": "nv.retrieveCompanyDMs",
  "label": "company1DMs",
  "success": false,
  "error": {
    "type": "retrievingNotAllowed",
    "message": "LinkedIn has blocked performing the retrieval."
  }
}
  • label – included only if specified in the action parameters.
  • error.type – enum with the following possible values:
    • retrievingNotAllowed – LinkedIn has blocked performing the retrieval due to exceeding limits or other restrictions.