nv_save_account
Plus-only root action nv.saveAccount. Ensure an account is saved; with listId, also ensure membership in that one list, leaving other lists untouched. Without listId, leave lists unchanged. Repeating succeeds without changes. Optional string ID, never a number. Eligible: owned custom account lists or My Current Accounts; other targets return listNotFound. Current limitation: If you have more than 10 account lists, Sales Navigator shows ten lists at a time. If the requested list is not shown, the call fails with unexpectedError. The account may already be saved, but not added to that list. 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 may fail with unexpectedError; retry it a little later. Returns a workflow acknowledgement; use get_workflow_result with operationName nvSaveAccount. Success has no result data.
Linked API actions are queued into a cloud-browser workflow and may take several minutes. The server returns immediately after starting the workflow with {status: 'pending'|'running', pendingReason, workflowId, operationName, message}. To retrieve the final result, call get_workflow_result with the returned workflowId and operationName — it will long-poll until completion or the request budget elapses, then return either the final result or another in-progress snapshot. Do not retry the original tool while a workflow is still running; that creates duplicate queued work.
A pending workflow carries pendingReason: 'queued' means it is waiting its turn behind other work on the same account and will start within minutes. 'outsideWorkingHours' means the account has configured working hours and the workflow is parked until they reopen — possibly the next working day. In that case get_workflow_result returns immediately instead of polling, message states when the window opens, and you should report that to the user rather than looping.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"companyHashedUrl": "<companyHashedUrl>"
},
"name": "nv_save_account"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| listId | No | Optional string ID, never a number. Eligible: owned custom account lists or My Current Accounts; other targets return listNotFound. Current limitation: If you have more than 10 account lists, Sales Navigator shows ten lists at a time. If the requested list is not shown, the call fails with unexpectedError. The account may already be saved, but not added to that list. | |
| companyHashedUrl | Yes | URL accepted by nv.openCompanyPage, including nv.retrieveAlerts subject.url. |