nv.createList

Create a lead list or an account list in Sales Navigator. For example, create one list per region, then save search results into each with nv.saveLead or nv.saveAccount, passing the new list's id as listId.

An active Sales Navigator subscription is required. To see the lists you already have, call nv.retrieveLists.

Constraints

⏺️ Root Start: allowed.

⬆️ Parent Actions: N/A.

⬇️ Child Actions: N/A.

Parameters

{
  "actionType": "nv.createList",
  "label": "emeaLeads",
  "type": "lead",
  "name": "EMEA leads",
  "description": "Heads of Sales in EMEA to follow up with"
}

const workflow = await linkedapi.nvCreateList.execute({
  type: "lead",
  name: "EMEA leads",
  description: "Heads of Sales in EMEA to follow up with"
});

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

from linkedapi import NvCreateListParams

workflow = linkedapi.nv_create_list.execute(
    NvCreateListParams(
        type="lead",
        name="EMEA leads",
        description="Heads of Sales in EMEA to follow up with",
    )
)

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

linkedin navigator lists create \
  --type lead \
  --name "EMEA leads" \
  --description "Heads of Sales in EMEA to follow up with" \
  --json

In AI assistants, the MCP tool is nv_create_list. The n8n action is Create list in Sales Navigator; the Make module is Create List in Sales Navigator.

A name or description outside these limits is rejected with invalidWorkflow before the workflow starts. Nothing is ever shortened.

List names

Sales Navigator itself lets several of your lists share a name. This action never creates such a duplicate, because the save menu used by nv.saveLead and nv.saveAccount shows lists by name only, so lists that share a name cannot be told apart there.

• One name per type. Before creating anything, the action reads all lists of the requested type that you own, Sales Navigator's system lists included. If one of them already has this name, the call fails with listAlreadyExists and no list is created.
• What counts as the same name. Names are compared after removing spaces at the start and end, and letter case counts. EMEA leads is the same name with or without spaces around it; EMEA Leads is a different name.
• System lists count. Sales Navigator's own lists, such as Recommended Leads and My Current Accounts, are among the lists you own. So a lead list cannot be named Recommended Leads, and an account list cannot be named My Current Accounts.
• Lead and account lists are separate. A lead list and an account list can have the same name.

Creating behaviour

• One call creates one list. The result describes the list this call created, including its id.
• Repeating the call does not create a second list. Calling again with the same type and name fails with listAlreadyExists, because the first call's list now has that name. If you lost the first call's result, find the list's id with nv.retrieveLists.
• A custom list. The new list appears in nv.retrieveLists with source set to MANUAL, and can be used as listId when saving leads (for a lead list) or accounts (for an account list).
• English interface only, for now. This is a current limitation: creating and deleting lists work only with an English Sales Navigator interface. On a German, Spanish, French or Portuguese interface, the call fails with interfaceLanguageNotSupported.

To delete a list, use nv.deleteList.

Result options

{
  "actionType": "nv.createList",
  "label": "emeaLeads",
  "success": true,
  "data": {
    "id": "7420000000000000004",
    "name": "EMEA leads",
    "type": "lead",
    "url": "https://www.linkedin.com/sales/lists/people/7420000000000000004"
  }
}

List IDs are long numeric strings, often 19 digits – beyond what a JavaScript number holds exactly. Keep them as strings; converting one to a number can change it.

label is included only if specified in the action parameters.

Error result

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

{
  "actionType": "nv.createList",
  "label": "emeaLeads",
  "success": false,
  "error": {
    "type": "listAlreadyExists",
    "message": "A Sales Navigator list of this type with this name already exists."
  }
}

Possible error.type values:

• noSalesNavigator — the account does not have an active Sales Navigator subscription.
• listAlreadyExists — you already own a list of this type with this name (see List names). No list is created.
• interfaceLanguageNotSupported — the account's Sales Navigator interface is German, Spanish, French or Portuguese rather than English. No list is created; this is a current limitation (see above).
• unexpectedError — the list could not be created, or Linked API could not read all of your lists of this type to check the name; in that case no list is created. It is safe to call again: if the failed call did create the list, the new call fails with listAlreadyExists instead of creating a second one.