nv.saveAccount

Save a company as an account in Sales Navigator and, optionally, add it to one of your account lists. Sales Navigator raises account alerts for the accounts you save. To read only alerts about subjects you saved, set filter.excludeSuggested to true in nv.retrieveAlerts. An alert's subject.url can be passed straight to this action.

An active Sales Navigator subscription is required. To find a list's ID, call nv.retrieveLists with type set to account. To create a new account list, call nv.createList and use the id it returns.

Constraints

⏺️ Root Start: allowed, when companyHashedUrl parameter is provided.

⬆️ Parent Actions: nv.openCompanyPage, nv.doForCompanies under nv.searchCompanies.

⬇️ Child Actions: N/A.

Parameters

{
  "actionType": "nv.saveAccount",
  "label": "saveAccount1",
  "companyHashedUrl": "https://www.linkedin.com/company/12345678",
  "listId": "7420000000000000003"
}

const workflow = await linkedapi.nvSaveAccount.execute({
  companyHashedUrl: "https://www.linkedin.com/company/12345678",
  listId: "7420000000000000003"
});

const { errors } = await linkedapi.nvSaveAccount.result(workflow.workflowId);

from linkedapi import NvSaveAccountParams

workflow = linkedapi.nv_save_account.execute(
    NvSaveAccountParams(
        company_hashed_url="https://www.linkedin.com/company/12345678",
        list_id="7420000000000000003",
    )
)

result = linkedapi.nv_save_account.result(workflow.workflow_id)

In AI assistants, the MCP tool is nv_save_account. The n8n action is Save account in Sales Navigator; the Make module is Save Account in Sales Navigator.

Parameter	Description
`label`	Optional label included in workflow completion.
`companyHashedUrl`	Required for root start, forbidden for parent start. LinkedIn URL of the company, in any form `nv.openCompanyPage` accepts: a hashed URL with the numeric company ID, an alert's `subject.url` (`/sales/company/…`), or a public company URL (`linkedin.com/company/<vanity>`), which costs one extra page load. Under a parent action, the company comes from the parent.
`listId`	Optional. ID of one of your custom account lists or of "My Current Accounts", as returned in `id` by `nv.retrieveLists` or `nv.createList`. Pass it as a string. Omit it to save the account without changing any list. More than 10 account lists, for now: Sales Navigator's save menu shows lists ten at a time. If you have more than 10 account lists and the requested list is not among those the menu shows, the call fails with `unexpectedError`. The account may already be saved by then, but is not added to that list. This is a current limitation.

Arg	Required	Description
`url`	yes	LinkedIn URL of the company: hashed, an alert's `subject.url`, or public

Flag	Description
`--list-id`	ID of one of your custom account lists or of "My Current Accounts". Omit to save without changing any list.

Saving behaviour

Saved, and in the list you name. The action makes sure the company is a saved account. With listId, it also makes sure the account is in that one list and leaves the account's other lists as they are. Without listId, no list changes.
Safe to repeat. Saving an account that is already saved, or already in the requested list, succeeds without changing anything.
Which lists you can save to. listId must be one of your custom account lists or "My Current Accounts". nv.retrieveLists can also return other system lists, but Sales Navigator does not offer them as save targets. Any other ID returns listNotFound, and nothing is written. The same applies when another of your account lists has exactly the same name: the save menu shows lists by name only, so rename one of them first. nv.createList never creates an account list with a name you already use.
Changes can take up to a few minutes to appear. Sales Navigator can take up to a few minutes to reflect a change. A call that conflicts with a change you just made through Linked API, such as unsaving an account you have just saved, may fail with unexpectedError; retry it a little later.
English interface only, for now. This is a current limitation: saving and unsaving work only with an English Sales Navigator interface. On a German, Spanish, French or Portuguese interface, the call fails with interfaceLanguageNotSupported.

To take the account out of one list and keep it saved, use nv.removeAccountFromList; to unsave it, use nv.unsaveAccount.

Saving from search results

Under nv.searchCompanies → nv.doForCompanies, the action saves each company straight from its search result, without opening its page. Saving 20 search results costs the search result pages instead of 20 extra company page loads, so your LinkedIn account does far less browsing for the same result. How many companies are saved is set by the parent action's limit.

Under nv.openCompanyPage, the action saves the company whose page is already open, so you can read its details and save it in one workflow.

nv.unsaveAccount is not available under nv.doForCompanies.

Workflow:

{
  "actionType": "nv.searchCompanies",
  "term": "fintech",
  "limit": 2,
  "filter": {
    "locations": ["Germany"]
  },
  "then": {
    "actionType": "nv.doForCompanies",
    "then": {
      "actionType": "nv.saveAccount",
      "listId": "7420000000000000003"
    }
  }
}

const workflow = await linkedapi.customWorkflow.execute({
  actionType: "nv.searchCompanies",
  term: "fintech",
  limit: 2,
  filter: {
    locations: ["Germany"]
  },
  then: {
    actionType: "nv.doForCompanies",
    then: {
      actionType: "nv.saveAccount",
      listId: "7420000000000000003"
    }
  }
});

const { data, errors } = await linkedapi.customWorkflow.result(workflow.workflowId);

workflow = linkedapi.custom_workflow.execute(
    {
        "actionType": "nv.searchCompanies",
        "term": "fintech",
        "limit": 2,
        "filter": {
            "locations": ["Germany"],
        },
        "then": {
            "actionType": "nv.doForCompanies",
            "then": {
                "actionType": "nv.saveAccount",
                "listId": "7420000000000000003",
            },
        },
    }
)

result = linkedapi.custom_workflow.result(workflow.workflow_id)

linkedin workflow run <<'EOF'
{
  "actionType": "nv.searchCompanies",
  "term": "fintech",
  "limit": 2,
  "filter": {
    "locations": ["Germany"]
  },
  "then": {
    "actionType": "nv.doForCompanies",
    "then": {
      "actionType": "nv.saveAccount",
      "listId": "7420000000000000003"
    }
  }
}
EOF

Completion:

json

{
  "actionType": "nv.searchCompanies",
  "success": true,
  "data": [
    {
      "name": "Example Pay",
      "urn": "urn:li:organization:12345678",
      "hashedUrl": "https://www.linkedin.com/company/12345678",
      "industry": "Financial Services",
      "employeesCount": 250,
      "logoUrl": null,
      "then": [
        {
          "actionType": "nv.saveAccount",
          "success": true
        }
      ]
    },
    {
      "name": "Ledger Labs",
      "urn": "urn:li:organization:87654321",
      "hashedUrl": "https://www.linkedin.com/company/87654321",
      "industry": "Software Development",
      "employeesCount": 80,
      "logoUrl": null,
      "then": [
        {
          "actionType": "nv.saveAccount",
          "success": true
        }
      ]
    }
  ]
}

Result options

json

{
  "actionType": "nv.saveAccount",
  "label": "saveAccount1",
  "success": true
}

A successful save has no data. label is included only if specified in the action parameters.

Error result

An unsuccessful action returns success: false with an error object:

json

{
  "actionType": "nv.saveAccount",
  "label": "saveAccount1",
  "success": false,
  "error": {
    "type": "listNotFound",
    "message": "The list is not available for this subject in Sales Navigator."
  }
}

Possible error.type values:

noSalesNavigator — the account does not have an active Sales Navigator subscription.
companyNotFound — the provided URL is not an existing LinkedIn company. This includes a public company URL that leads to no LinkedIn company page.
listNotFound — listId is not one of your custom account lists or "My Current Accounts". This is checked before anything is written. Rarely, a valid list is missing from the account's save menu; the account may then already be saved when this error is returned.
interfaceLanguageNotSupported — the account's Sales Navigator interface is German, Spanish, French or Portuguese rather than English. Nothing is changed; this is a current limitation (see above).
unexpectedError — the save could not be completed. This includes a call that conflicts with a change you just made through Linked API: Sales Navigator can take up to a few minutes to reflect a change, so retry it a little later. It also includes a listId that the save menu did not show when you have more than 10 account lists (see listId).

Previousnv.openCompanyPage Nextnv.unsaveAccount