nv.createSavedSearch

Save a Sales Navigator lead search or account search, given the search's URL. For example, build a search in Sales Navigator, copy its URL from the address bar, and save it so Sales Navigator keeps track of it. To read the saved search's results later, pass its url as customSearchUrl to nv.searchPeople or nv.searchCompanies.

An active Sales Navigator subscription is required. To see the searches you already saved, call nv.retrieveSavedSearches.

Constraints

⏺️ Root Start: allowed.

⬆️ Parent Actions: N/A.

⬇️ Child Actions: N/A.

Parameters

{
  "actionType": "nv.createSavedSearch",
  "label": "headsOfSales",
  "type": "lead",
  "customSearchUrl": "https://www.linkedin.com/sales/search/people?query=(spellCorrectionEnabled%3Atrue%2Ckeywords%3AHead%2520of%2520Sales)"
}

const workflow = await linkedapi.nvCreateSavedSearch.execute({
  type: "lead",
  customSearchUrl: "https://www.linkedin.com/sales/search/people?query=(spellCorrectionEnabled%3Atrue%2Ckeywords%3AHead%2520of%2520Sales)"
});

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

from linkedapi import NvCreateSavedSearchParams

workflow = linkedapi.nv_create_saved_search.execute(
    NvCreateSavedSearchParams(
        type="lead",
        custom_search_url="https://www.linkedin.com/sales/search/people?query=(spellCorrectionEnabled%3Atrue%2Ckeywords%3AHead%2520of%2520Sales)",
    )
)

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

linkedin navigator saved-searches create \
  "https://www.linkedin.com/sales/search/people?query=(spellCorrectionEnabled%3Atrue%2Ckeywords%3AHead%2520of%2520Sales)" \
  --type lead \
  --json

In AI assistants, the MCP tool is nv_create_saved_search. The n8n action is Create saved search in Sales Navigator; the Make module is Create Saved Search in Sales Navigator.

A customSearchUrl that is not a Sales Navigator search of the requested type is rejected with invalidWorkflow before the workflow starts.

Saving behaviour

• Saved with Sales Navigator's own control. The action opens the search and saves it with Sales Navigator's Save search control, as you would in the browser. The result describes the saved search, including its id.
• A search that is already saved. If customSearchUrl opens one of your saved searches, as a URL copied while viewing a saved search or a saved search's url from nv.retrieveSavedSearches does (its URL carries ?savedSearchId=), nothing new is saved: the result describes that existing saved search. A successful call therefore does not prove that a new saved search was created. To tell the two apart, compare the result's id with the IDs nv.retrieveSavedSearches returned before the call.
• Sales Navigator names it. The saved search gets Sales Navigator's default name, such as Lead Search 1. Choosing a name, notification settings, or new-results-only reading is not available yet.
• Use a URL copied from Sales Navigator. The search must open in Sales Navigator exactly as given. A URL copied from Sales Navigator's address bar works. If Sales Navigator changes the search when it opens the URL, the call fails with unexpectedError and nothing is saved.
• No duplicate check for equivalent searches. Apart from that case, Linked API does not check whether another of your saved searches has the same criteria. To avoid saving one twice, look it up with nv.retrieveSavedSearches first.
• One call saves at most one search. If the call is retried internally, it never saves the search twice.
• English interface only, for now. This is a current limitation: saved searches work only with an English Sales Navigator interface. On a German, Spanish, French or Portuguese interface, the call fails with interfaceLanguageNotSupported.

To delete a saved search, use nv.deleteSavedSearch.

Result options

{
  "actionType": "nv.createSavedSearch",
  "label": "headsOfSales",
  "success": true,
  "data": {
    "id": "1900000001",
    "name": "Lead Search 1",
    "type": "lead",
    "url": "https://www.linkedin.com/sales/search/people?savedSearchId=1900000001"
  }
}

label is included only if specified in the action parameters.

Error result

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

{
  "actionType": "nv.createSavedSearch",
  "label": "headsOfSales",
  "success": false,
  "error": {
    "type": "interfaceLanguageNotSupported",
    "message": "This action currently supports only the English Sales Navigator interface."
  }
}

Possible error.type values:

• noSalesNavigator — the account does not have an active Sales Navigator subscription.
• interfaceLanguageNotSupported — the account's Sales Navigator interface is German, Spanish, French or Portuguese rather than English. Nothing is saved; this is a current limitation (see above).
• unexpectedError — the search could not be saved, or Linked API could not confirm that it was. In the second case it may have been saved anyway: check nv.retrieveSavedSearches before calling again, so you do not save it twice.