nv.deleteList

Delete one of your lead lists or account lists in Sales Navigator. Only the list is deleted: its leads or accounts stay saved and stay in their other lists.

An active Sales Navigator subscription is required. To find a list's ID, call nv.retrieveLists.

Constraints

⏺️ Root Start: allowed.

⬆️ Parent Actions: N/A.

⬇️ Child Actions: N/A.

Parameters

{
  "actionType": "nv.deleteList",
  "label": "deleteEmeaLeads",
  "listId": "7420000000000000004"
}

const workflow = await linkedapi.nvDeleteList.execute({
  listId: "7420000000000000004"
});

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

from linkedapi import NvDeleteListParams

workflow = linkedapi.nv_delete_list.execute(
    NvDeleteListParams(
        list_id="7420000000000000004",
    )
)

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

linkedin navigator lists delete 7420000000000000004 --json

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

Invalid parameters are rejected with invalidWorkflow before the workflow starts.

Deleting behaviour

• Only the list. The list with this listId is deleted, and nothing else. Its leads or accounts stay saved and stay in any other lists they are in. Sales Navigator's own delete dialog can also unsave the list's members; Linked API always keeps them saved. To unsave members, use nv.unsaveLead or nv.unsaveAccount for each of them.
• Exactly the list you name. The list is found by its ID, so another list with the same name is never touched.
• System lists cannot be deleted. Sales Navigator offers no Delete for its own lists, such as Recommended Leads and My Current Accounts. Passing one of their IDs fails with listNotDeletable, and nothing is deleted.
• Only your own lists. listId must be a list you own, as returned by nv.retrieveLists. A list someone else shared with you, or an ID that is not one of your lists, fails with listNotFound.
• Deleting twice. A list that is already deleted is no longer one of your lists, so deleting it again fails with listNotFound.
• 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 create a list, use nv.createList.

Result options

{
  "actionType": "nv.deleteList",
  "label": "deleteEmeaLeads",
  "success": true
}

A successful delete 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:

{
  "actionType": "nv.deleteList",
  "label": "deleteEmeaLeads",
  "success": false,
  "error": {
    "type": "listNotDeletable",
    "message": "This Sales Navigator list cannot be deleted."
  }
}

Possible error.type values:

• noSalesNavigator — the account does not have an active Sales Navigator subscription.
• listNotFound — listId is not one of your lead or account lists. This includes a list that is already deleted and a list someone else shared with you. Nothing is deleted.
• listNotDeletable — the list is one of your lists, but Sales Navigator does not allow deleting it, as with system lists such as Recommended Leads and My Current Accounts. Nothing is deleted.
• interfaceLanguageNotSupported — the account's Sales Navigator interface is German, Spanish, French or Portuguese rather than English. Nothing is deleted; this is a current limitation (see above).
• unexpectedError — the list could not be deleted.