Adds people to an existing list (listId) or to a new one created in the same call (newList). People are REFERENCES the workspace already holds: runResultIds from GET /api/v1/lead-search/runs/{runId}. A person already in the list is not added twice; a person on a do-not-contact list is withheld and counted in suppressed. Send an Idempotency-Key so a retried “create and add” reuses the list it created.
Workspace API key (loice_sk_ + 48 hex characters), created under Settings → API Keys. Sent as Authorization: Bearer loice_sk_…. Invalid, missing, or expired keys are rejected with 401 before any billable work happens.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Loice","description":"Loice is the AI agent that finds verified leads: product guides, API reference and MCP set-up.","colors":{"primary":"#ff5a1f","light":"#ff7c46","dark":"#e14e15"},"logo":{"light":"https://mintcdn.com/loice-ai/BjcqR91eFdyMv2fQ/logo/loice-black.png?fit=max\u0026auto=format\u0026n=BjcqR91eFdyMv2fQ\u0026q=85\u0026s=bec1e804b7d2b4e6090aad41f5ec149e","dark":"https://mintcdn.com/loice-ai/BjcqR91eFdyMv2fQ/logo/loice-white.png?fit=max\u0026auto=format\u0026n=BjcqR91eFdyMv2fQ\u0026q=85\u0026s=047e3e67ec3049b5fd51a830b6d6ecf5","href":"https://app.loice.ai"},"favicon":"https://mintcdn.com/loice-ai/idv10iVf8OQiCSpv/favicon.svg?fit=max\u0026auto=format\u0026n=idv10iVf8OQiCSpv\u0026q=85\u0026s=a2b1dfa846aba2dd2708a97f2239882d","api":{"openapi":"openapi.json","playground":{"display":"interactive","proxy":false,"credentials":false},"examples":{"defaults":"required","languages":["curl","javascript","node","python"]}},"navbar":{"links":[{"href":"/connect-mcp","label":"Connect MCP"},{"href":"https://app.loice.ai/settings/account?tab=api","label":"API keys"}],"primary":{"type":"button","label":"Open Loice","href":"https://app.loice.ai"}},"footer":{"links":[{"header":"Loice","items":[{"label":"App","href":"https://app.loice.ai"},{"label":"Website","href":"https://loice.ai"},{"label":"Status","href":"https://status.loice.ai"}]}]},"contextual":{"options":["copy","view"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"loice-ai","hasAudioNarration":false,"actualSubdomain":"loice-ai","customDomains":["docs.loice.ai"],"gitSource":{"type":"github","owner":"loice-ai","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"DISABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6af3055c2e595ebec461a1ad","clientVersion":"0.0.4094","searchFilterCounts":[{"language":"default","tag":"Documentation","count":24},{"language":"default","tag":"API reference","count":12},{"language":"default","tag":"API Reference","count":12},{"language":"default","tag":"API basics","count":8},{"language":"default","tag":"Product","count":7},{"language":"default","tag":"Account","count":4},{"language":"default","tag":"Get started","count":3},{"language":"default","tag":"Integrations","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/save-lead-search-results-to-a-list","slug":"/api-reference/save-lead-search-results-to-a-list","pageMetadata":{"title":"Save lead-search results to a list","description":"Adds people to an existing list (`listId`) or to a new one created in the same call (`newList`). People are REFERENCES the workspace already holds: `runResultIds` from `GET /api/v1/lead-search/runs/{runId}`. A person already in the list is not added twice; a person on a do-not-contact list is withheld and counted in `suppressed`. Send an `Idempotency-Key` so a retried “create and add” reuses the list it created.\n\n#### Billing\n\nFree — this endpoint does not consume points.","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/lead-lists/add","href":"/api-reference/save-lead-search-results-to-a-list","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n h4: \"h4\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [\"Adds people to an existing list (\", _jsx(_components.code, {\n children: \"listId\"\n }), \") or to a new one created in the same call (\", _jsx(_components.code, {\n children: \"newList\"\n }), \"). People are REFERENCES the workspace already holds: \", _jsx(_components.code, {\n children: \"runResultIds\"\n }), \" from \", _jsx(_components.code, {\n children: \"GET /api/v1/lead-search/runs/{runId}\"\n }), \". A person already in the list is not added twice; a person on a do-not-contact list is withheld and counted in \", _jsx(_components.code, {\n children: \"suppressed\"\n }), \". Send an \", _jsx(_components.code, {\n children: \"Idempotency-Key\"\n }), \" so a retried “create and add” reuses the list it created.\"]\n }), \"\\n\", _jsx(_components.h4, {\n children: \"Billing\"\n }), \"\\n\", _jsx(_components.p, {\n children: \"Free — this endpoint does not consume points.\"\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Save lead-search results to a list","description":"Adds people to an existing list (`listId`) or to a new one created in the same call (`newList`). People are REFERENCES the workspace already holds: `runResultIds` from `GET /api/v1/lead-search/runs/{runId}`. A person already in the list is not added twice; a person on a do-not-contact list is withheld and counted in `suppressed`. Send an `Idempotency-Key` so a retried “create and add” reuses the list it created.\n\n#### Billing\n\nFree — this endpoint does not consume points.","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/lead-lists/add","href":"/api-reference/save-lead-search-results-to-a-list","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Save lead-search results to a list","description":"Adds people to an existing list (`listId`) or to a new one created in the same call (`newList`). People are REFERENCES the workspace already holds: `runResultIds` from `GET /api/v1/lead-search/runs/{runId}`. A person already in the list is not added twice; a person on a do-not-contact list is withheld and counted in `suppressed`. Send an `Idempotency-Key` so a retried “create and add” reuses the list it created.\n\n#### Billing\n\nFree — this endpoint does not consume points.","security":["839f163c-c814-4163-a9be-468212a12906"],"requestBody":"c46d2f77-ef78-4186-ba35-9c82e8167a6b","responses":{"200":"30597a8c-8d24-488f-b974-57927ef60f66","400":"5478a77e-07c8-4b2f-acbc-e287f4e4a6b1","401":"35b43e40-35be-4085-98e4-5b206c8b9c28","404":"d5dd1ce3-d776-4150-9db2-3449515ea70d","405":"bfd4315c-4fbf-48d7-985a-9dfbd4f687f6","409":"3800ced0-d9e4-487d-b3da-28b6bf77e84c","429":"14c8c819-b82b-42de-9a2a-1faa74c244e7","500":"49486cf6-bbb5-4c5a-b119-1919a152af97"},"method":"post","type":"path","servers":["695260fa-a90d-430f-9fda-0588978e186c"],"path":"/api/v1/lead-lists/add","baseUrlOptions":["https://app.loice.ai"],"title":"Save lead-search results to a list","codeSamples":[],"requestExampleLanguages":["bash","javascript","node","python"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated","disableProxy":true},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"listId":{"type":"string","minLength":1,"maxLength":64,"uniqueKey":"listId","typeLabel":"string"},"newList":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120,"isRequired":true,"uniqueKey":"newList.name","typeLabel":"string"},"description":{"type":"string","maxLength":1000,"uniqueKey":"newList.description","typeLabel":"string"}},"required":["name"],"uniqueKey":"newList","typeLabel":"object"},"runResultIds":{"type":"array","items":{"type":"string","minLength":1,"maxLength":64,"uniqueKey":"runResultIds.items.[INDEX]","typeLabel":"string"},"maxItems":1000,"uniqueKey":"runResultIds","typeLabel":"string[]"},"lookupIds":{"type":"array","items":{"type":"string","minLength":1,"maxLength":64,"uniqueKey":"lookupIds.items.[INDEX]","typeLabel":"string"},"maxItems":1000,"uniqueKey":"lookupIds","typeLabel":"string[]"},"bulkRowIds":{"type":"array","items":{"type":"string","minLength":1,"maxLength":64,"uniqueKey":"bulkRowIds.items.[INDEX]","typeLabel":"string"},"maxItems":1000,"uniqueKey":"bulkRowIds","typeLabel":"string[]"},"bulkBatchId":{"type":"string","minLength":1,"maxLength":64,"uniqueKey":"bulkBatchId","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"newList":{"name":"Fintech CFOs"},"runResultIds":["cmf3x0v2b0002abcd"]},"examples":{"Example":{"title":"Example","value":{"newList":{"name":"Fintech CFOs"},"runResultIds":["cmf3x0v2b0002abcd"]}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"30597a8c-8d24-488f-b974-57927ef60f66":{"description":"What was added.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"listId":{"type":"string","isRequired":true,"uniqueKey":"data.listId","typeLabel":"string"},"listName":{"type":"string","isRequired":true,"uniqueKey":"data.listName","typeLabel":"string"},"listCreated":{"type":"boolean","isRequired":true,"uniqueKey":"data.listCreated","typeLabel":"boolean"},"added":{"type":"integer","isRequired":true,"uniqueKey":"data.added","typeLabel":"integer"},"alreadyInList":{"type":"integer","isRequired":true,"uniqueKey":"data.alreadyInList","typeLabel":"integer"},"suppressed":{"type":"integer","description":"People withheld by a do-not-contact entry; nothing about them is stored.","isRequired":true,"uniqueKey":"data.suppressed","typeLabel":"integer"},"skipped":{"type":"integer","description":"References not added: unknown, of another workspace, erased or expired, or with nothing to identify the person. `skippedReasons` splits them.","isRequired":true,"uniqueKey":"data.skipped","typeLabel":"integer"},"skippedReasons":{"type":"object","properties":{"unavailable":{"type":"integer","description":"Unknown, of another workspace, erased or expired.","isRequired":true,"uniqueKey":"data.skippedReasons.unavailable","typeLabel":"integer"},"noIdentity":{"type":"integer","description":"Nothing identifies the person: no LinkedIn profile, no address, no name and company.","isRequired":true,"uniqueKey":"data.skippedReasons.noIdentity","typeLabel":"integer"}},"required":["unavailable","noIdentity"],"description":"Why each skipped reference was not added; sums to `skipped`.","isRequired":true,"uniqueKey":"data.skippedReasons","typeLabel":"object"},"merged":{"type":"integer","description":"Contacts this add merged into others: it proved they are one person (a shared LinkedIn profile or address, or — for people found on a company website with no profile — the same name at the same company).","isRequired":true,"uniqueKey":"data.merged","typeLabel":"integer"},"autoSyncRunId":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.autoSyncRunId.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.autoSyncRunId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.autoSyncRunId","typeLabel":"string | null"}},"required":["listId","listName","listCreated","added","alreadyInList","suppressed","skipped","skippedReasons","merged","autoSyncRunId"],"isRequired":true,"uniqueKey":"data","typeLabel":"object"}},"required":["data"],"uniqueKey":"","typeLabel":"object"},"example":{"data":{"listId":"cmf3x0v2b0001abcd","listName":"Fintech CFOs","listCreated":true,"added":1,"alreadyInList":0,"suppressed":0,"skipped":0,"autoSyncRunId":null}},"examples":{"Example":{"title":"Example","value":{"data":{"listId":"cmf3x0v2b0001abcd","listName":"Fintech CFOs","listCreated":true,"added":1,"alreadyInList":0,"suppressed":0,"skipped":0,"autoSyncRunId":null}}}},"exampleType":"examples"}},"exampleType":"examples"},"5478a77e-07c8-4b2f-acbc-e287f4e4a6b1":{"description":"`validation_error`: the body is invalid (the message names the problem).","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error","unauthenticated","not_found","forbidden","method_not_allowed","idempotency_conflict","idempotency_in_progress","rate_limited","internal_error","run_already_active","run_already_continued","search_unavailable","invalid_continuation","invalid_input","insufficient_credits","incomplete"],"description":"Machine-readable error code. Branch on this, not on `message`.","isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable explanation.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"retryAfterSeconds":{"type":"integer","description":"Present on a 429 only: seconds until the workspace may call again (same value as the `Retry-After` header).","uniqueKey":"error.retryAfterSeconds","typeLabel":"integer"}},"required":["code","message"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"validation_error","message":"\u003cstring>","retryAfterSeconds":123}}}},"exampleType":"generated"}},"exampleType":"generated"},"35b43e40-35be-4085-98e4-5b206c8b9c28":{"description":"API key missing (`Missing API key. Pass it as: Authorization: Bearer \u003ckey>`), invalid (`Invalid API key`), or expired (`This API key has expired`).","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"required":["message"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"d5dd1ce3-d776-4150-9db2-3449515ea70d":{"description":"`not_found`: no such active list in this workspace.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error","unauthenticated","not_found","forbidden","method_not_allowed","idempotency_conflict","idempotency_in_progress","rate_limited","internal_error","run_already_active","run_already_continued","search_unavailable","invalid_continuation","invalid_input","insufficient_credits","incomplete"],"description":"Machine-readable error code. Branch on this, not on `message`.","isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable explanation.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"retryAfterSeconds":{"type":"integer","description":"Present on a 429 only: seconds until the workspace may call again (same value as the `Retry-After` header).","uniqueKey":"error.retryAfterSeconds","typeLabel":"integer"}},"required":["code","message"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"validation_error","message":"\u003cstring>","retryAfterSeconds":123}}}},"exampleType":"generated"}},"exampleType":"generated"},"bfd4315c-4fbf-48d7-985a-9dfbd4f687f6":{"description":"Method not allowed — see the `Allow` response header.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"required":["message"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"3800ced0-d9e4-487d-b3da-28b6bf77e84c":{"description":"`list_name_taken`: a new list’s name is already used; `idempotency_conflict`: the key was used for a different request.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error","unauthenticated","not_found","forbidden","method_not_allowed","idempotency_conflict","idempotency_in_progress","rate_limited","internal_error","run_already_active","run_already_continued","search_unavailable","invalid_continuation","invalid_input","insufficient_credits","incomplete"],"description":"Machine-readable error code. Branch on this, not on `message`.","isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable explanation.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"retryAfterSeconds":{"type":"integer","description":"Present on a 429 only: seconds until the workspace may call again (same value as the `Retry-After` header).","uniqueKey":"error.retryAfterSeconds","typeLabel":"integer"}},"required":["code","message"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"validation_error","message":"\u003cstring>","retryAfterSeconds":123}}}},"exampleType":"generated"}},"exampleType":"generated"},"14c8c819-b82b-42de-9a2a-1faa74c244e7":{"description":"Rate limit exceeded for this workspace. Retry after the number of seconds in the `Retry-After` header (60). Rate-limited calls are never billed.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"required":["message"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"49486cf6-bbb5-4c5a-b119-1919a152af97":{"description":"`internal_error`: the write failed on our side.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error","unauthenticated","not_found","forbidden","method_not_allowed","idempotency_conflict","idempotency_in_progress","rate_limited","internal_error","run_already_active","run_already_continued","search_unavailable","invalid_continuation","invalid_input","insufficient_credits","incomplete"],"description":"Machine-readable error code. Branch on this, not on `message`.","isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable explanation.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"retryAfterSeconds":{"type":"integer","description":"Present on a 429 only: seconds until the workspace may call again (same value as the `Retry-After` header).","uniqueKey":"error.retryAfterSeconds","typeLabel":"integer"}},"required":["code","message"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"validation_error","message":"\u003cstring>","retryAfterSeconds":123}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"839f163c-c814-4163-a9be-468212a12906":{"workspaceApiKey":{"type":"http","scheme":"bearer","description":"Workspace API key (`loice_sk_` + 48 hex characters), created under Settings → API Keys. Sent as `Authorization: Bearer loice_sk_…`. Invalid, missing, or expired keys are rejected with 401 before any billable work happens.","scopes":[],"schemeName":"workspaceApiKey"}}},"servers":{"695260fa-a90d-430f-9fda-0588978e186c":{"url":"https://app.loice.ai"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Workspace API key (`loice_sk_` + 48 hex characters), created under Settings → API Keys. Sent as `Authorization: Bearer loice_sk_…`. Invalid, missing, or expired keys are rejected with 401 before any billable work happens.","scopes":[],"schemeName":"workspaceApiKey"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Workspace API key (`loice_sk_` + 48 hex characters), created under Settings → API Keys. Sent as `Authorization: Bearer loice_sk_…`. Invalid, missing, or expired keys are rejected with 401 before any billable work happens.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"workspaceApiKey","name":"Authorization"}],"title":"workspaceApiKey"}]},"originalFileLocation":"openapi.json"},"subdomain":"loice-ai","siteName":"Loice","title":"Save lead-search results to a list - Loice","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-09T13:15:54.103Z","originalFileLocation":"api-reference/save-lead-search-results-to-a-list.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Adds people to an existing list (listId) or to a new one created in the same call (newList). People are REFERENCES the workspace already holds: runResultIds from GET /api/v1/lead-search/runs/{runId}. A person already in the list is not added twice; a person on a do-not-contact list is withheld and counted in suppressed. Send an Idempotency-Key so a retried “create and add” reuses the list it created. #### Billing Free — this endpoint does not consume points.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Loice\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/loice-ai/dsWJfncwTF1mrm64/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/loice-ai/dsWJfncwTF1mrm64/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/loice-ai/dsWJfncwTF1mrm64/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/loice-ai/dsWJfncwTF1mrm64/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/loice-ai/dsWJfncwTF1mrm64/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/loice-ai/dsWJfncwTF1mrm64/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/loice-ai/dsWJfncwTF1mrm64/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/loice-ai/dsWJfncwTF1mrm64/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/loice-ai/dsWJfncwTF1mrm64/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Save lead-search results to a list - Loice\">\u003cmeta data-mint-head property=\"og:description\" content=\"Adds people to an existing list (listId) or to a new one created in the same call (newList). People are REFERENCES the workspace already holds: runResultIds from GET /api/v1/lead-search/runs/{runId}. A person already in the list is not added twice; a person on a do-not-contact list is withheld and counted in suppressed. Send an Idempotency-Key so a retried “create and add” reuses the list it created. #### Billing Free — this endpoint does not consume points.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Loice\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.loice.ai/api-reference/save-lead-search-results-to-a-list\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://loice-ai.mintlify.site/_mintlify/api/og/v2?division=API+Reference\u0026amp;title=Save+lead-search+results+to+a+list\u0026amp;description=Adds+people+to+an+existing+list+%28%60listId%60%29+or+to+a+new+one+created+in+the+same+call+%28%60newList%60%29.+People+are+REFERENCES+the+workspace+already+holds%3A+%60runResultId\u0026amp;theme=aaaf477007e472ee8ada61f7\u0026amp;signature=8c43289ec722471ab1f9ad0b826efee051ba13e270a59318f26c7b91ef393617\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Save lead-search results to a list - Loice\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Adds people to an existing list (listId) or to a new one created in the same call (newList). People are REFERENCES the workspace already holds: runResultIds from GET /api/v1/lead-search/runs/{runId}. A person already in the list is not added twice; a person on a do-not-contact list is withheld and counted in suppressed. Send an Idempotency-Key so a retried “create and add” reuses the list it created. #### Billing Free — this endpoint does not consume points.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://loice-ai.mintlify.site/_mintlify/api/og/v2?division=API+Reference\u0026amp;title=Save+lead-search+results+to+a+list\u0026amp;description=Adds+people+to+an+existing+list+%28%60listId%60%29+or+to+a+new+one+created+in+the+same+call+%28%60newList%60%29.+People+are+REFERENCES+the+workspace+already+holds%3A+%60runResultId\u0026amp;theme=aaaf477007e472ee8ada61f7\u0026amp;signature=8c43289ec722471ab1f9ad0b826efee051ba13e270a59318f26c7b91ef393617\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/loice-ai/dsWJfncwTF1mrm64/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Loice\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#ff5a1f\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.loice.ai/api-reference/save-lead-search-results-to-a-list\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/save-lead-search-results-to-a-list.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.loice.ai/#organization\",\"name\":\"Loice\",\"url\":\"https://docs.loice.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/loice-ai/BjcqR91eFdyMv2fQ/logo/loice-black.png?fit=max\u0026auto=format\u0026n=BjcqR91eFdyMv2fQ\u0026q=85\u0026s=bec1e804b7d2b4e6090aad41f5ec149e\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.loice.ai#website\",\"name\":\"Loice\",\"url\":\"https://docs.loice.ai\",\"publisher\":{\"@id\":\"https://docs.loice.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.loice.ai/api-reference/save-lead-search-results-to-a-list#webpage\",\"url\":\"https://docs.loice.ai/api-reference/save-lead-search-results-to-a-list\",\"name\":\"Save lead-search results to a list\",\"description\":\"Adds people to an existing list (listId) or to a new one created in the same call (newList). People are REFERENCES the workspace already holds: runResultIds from GET /api/v1/lead-search/runs/{runId}. A person already in the list is not added twice; a person on a do-not-contact list is withheld and counted in suppressed. Send an Idempotency-Key so a retried “create and add” reuses the list it created. #### Billing Free — this endpoint does not consume points.\",\"dateModified\":\"2026-11-09T13:15:54.103Z\",\"isPartOf\":{\"@id\":\"https://docs.loice.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.loice.ai/api-reference/save-lead-search-results-to-a-list#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.loice.ai/api-reference/save-lead-search-results-to-a-list#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Reference\",\"item\":\"https://docs.loice.ai/api-reference/find-and-verify-email\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Save lead-search results to a list\",\"item\":\"https://docs.loice.ai/api-reference/save-lead-search-results-to-a-list\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.loice.ai/api-reference/save-lead-search-results-to-a-list#apireference\",\"headline\":\"Save lead-search results to a list\",\"name\":\"Save lead-search results to a list\",\"description\":\"Adds people to an existing list (listId) or to a new one created in the same call (newList). People are REFERENCES the workspace already holds: runResultIds from GET /api/v1/lead-search/runs/{runId}. A person already in the list is not added twice; a person on a do-not-contact list is withheld and counted in suppressed. Send an Idempotency-Key so a retried “create and add” reuses the list it created. #### Billing Free — this endpoint does not consume points.\",\"url\":\"https://docs.loice.ai/api-reference/save-lead-search-results-to-a-list\",\"mainEntityOfPage\":{\"@id\":\"https://docs.loice.ai/api-reference/save-lead-search-results-to-a-list#webpage\"},\"dateModified\":\"2026-11-09T13:15:54.103Z\",\"publisher\":{\"@id\":\"https://docs.loice.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.loice.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Loice\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Loice","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":""}]},{"tab":"API reference","groups":[{"group":"API Reference","pages":[{"title":"Find and verify email","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/find","href":"/api-reference/find-and-verify-email"},{"title":"Enrich an email address","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/enrich/email","href":"/api-reference/enrich-an-email-address"},{"title":"Search LinkedIn profiles by name","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/linkedin-search","href":"/api-reference/search-linkedin-profiles-by-name"},{"title":"Start lead search","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/lead-search","href":"/api-reference/start-lead-search"},{"title":"Start an employee search","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/employee-search","href":"/api-reference/start-an-employee-search"},{"title":"Poll lead search","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/lead-search/runs/{runId}","href":"/api-reference/poll-lead-search"},{"title":"Cancel lead search","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/lead-search/runs/{runId}/cancel","href":"/api-reference/cancel-lead-search"},{"title":"List lead lists","description":"Returns one page (25) of the workspace’s active lead lists, most recently changed first, each with its member, verified-email, mobile and CRM-sync counts.\n\n#### Billing\n\nFree — this endpoint does not consume points.","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/lead-lists","href":"/api-reference/list-lead-lists"},{"title":"Save lead-search results to a list","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/lead-lists/add","href":"/api-reference/save-lead-search-results-to-a-list"},{"title":"Read a list’s members","description":"Returns one page (25) of a list’s members, each as the canonical Person plus the email and mobile this workspace revealed and the CRM sync state. Filter with `q`, `hasEmail`, `emailValid`, `hasMobile`, `crm` and `source`; order with `sort`.\n\n#### Billing\n\nFree — this endpoint does not consume points.","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/lead-lists/{listId}/members","href":"/api-reference/read-a-list’s-members"},{"title":"Check the points balance","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/points","href":"/api-reference/check-the-points-balance"},{"title":"This API description","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/openapi.json","href":"/api-reference/this-api-description"}]}]}]},"basePath":"","title":"Save lead-search results to a list - Loice","buildId":"dpl_42LwxxU1kGN114H4XzwGYXa9ZDah","deploymentId":"dpl_42LwxxU1kGN114H4XzwGYXa9ZDah","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-C-hEh3I2.js","utils-CnF4QiUD.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-C7PVNbel.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-8ytevL2A.js","snippetPresets-BT1alx3v.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BLXC0i_W.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CyLIGI9_.js","shallow-DC0lGVIW.js","getApiPlaygroundDisplay-CgDQ85tN.js","CodeSnippet-6-I-Gpv9.js","CodeSnippets-BAk1kDdu.js","Page-C945cI-W.js","getPastedJson-B276RuWN.js","icon-BqP8etTm.js","MethodPill-DM6sbxG1.js","DuplicateIcon-PyJglOaE.js","createIcon-CMeOMAc_.js","DynamicMarkdown-BoyYAA8K.js","SectionHeading-DAYv3gvZ.js","axios-vUo_bRtp.js","Markdown-BhTTmazV.js","clsx-CR-RHrVC.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CBUH0-zX.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BmARFYNC.js"]}