{
"status": "error",
"data": null,
"message": "An error occurred while processing the request"
}
{
"status": "error",
"data": null,
"message": "An error occurred while processing the request"
}
{
"status": "error",
"data": null,
"message": "An error occurred while processing the request"
}
{
"status": "error",
"data": null,
"message": "An error occurred while processing the request"
}
{
"status": "error",
"data": null,
"message": "An error occurred while processing the request"
}
Lead Finder
Import Prospects
Starts a paid import of prospects into a prospect list of a campaign. FILTERS buys count live matches of the same query starting at zero-based startOffset (default 0); startOffset + count must not exceed limits.resultCeiling. Skipped rows are not retrieved or charged. SELECTED permits only omitted or zero offset. Live ordering can shift; no unique or new prospects are guaranteed. After a completed import, the next window starts at its accepted startOffset + breakdown.processed, not added. A failed or cancelled purchase is not an automatic continuation. The charge is per prospect retrieved, not per prospect added: each retrieved prospect costs 1 credit, including prospects that end up not added (already in prospects, invalid, or over Prospect Capacity). The response comes as soon as the import is accepted, with three ids: the import, the campaign and the list (the new list when listName was given).
The start is refused, and nothing is created or charged:
400: The request is refused: its query as the preview refuses it (named by its path such as query.filters[0].values and, where known, its field and op), a campaign that is not a Prospects campaign (TARGET_USER), a list of another campaign, a count above the Prospect Capacity left or the search schema’s limits.resultCeiling, a balance that does not cover the cost, or a cost that could exceed maxCreditsSpend.
403: The caller cannot update the campaign, the plan is inactive or cannot spend credits, or the idempotencyKey belongs to another workspace, user or API key.
404: The campaign or the list does not exist.
409: Another import of the campaign owner is still running; wait until it ends, then start again.
One idempotencyKey names one purchase: a retry with the same key returns the original purchase with replayed: true; its campaignId and listId may differ from this request; nothing new is started or charged. After a timeout, a network error, a 5xx or a 408, retry with the same key, since the purchase may already exist under it; after a 429, wait for Retry-After and retry with the same key. A 403 saying the idempotencyKey belongs to another workspace, user or API key means the key already names a purchase made by another caller: it is not proof that nothing was bought, so retry only with the same API key or user that made it. Any other 4xx means no purchase was created, and a new purchase takes a new key. The result — prospects added and credits charged — is not part of this response; it can be read by the import id once the import ends.
FILTERS requests count matches of query starting at startOffset, not a page of guaranteed unimported people; SELECTED uses distinct preview providerIds. Selected IDs not returned by the provider are skipped, so delivery is not guaranteed.
The most credits this import may charge: count × 1 for FILTERS, the number of distinct providerIds × 1 for SELECTED; 1 credit per retrieved prospect. The start is refused when the cost could exceed it.
FILTERS only: the people-search query, the flat list of conditions {"filters":[…]} in the grammar Get Lead Finder Search Schema publishes — the same query the preview took. Omit for SELECTED: it does not select or exclude people, although a supplied query still must pass the gateway’s input validation. A key the grammar does not accept is refused, naming it; no key is dropped silently.
FILTERS: required number of matches to request from startOffset in the live query results. Omit for SELECTED: selection uses distinct providerIds, not count. If supplied, count still must pass the input type and bounds. A count above the Prospect Capacity left or above what the balance covers, or a window with startOffset + count above the search schema's limits.resultCeiling, is refused before anything starts; an import is never trimmed to fit. The import stops when matches run out and charges only what it retrieved. Previously imported people may appear in the window and are retrieved and charged again; live ordering can shift, so a later offset does not guarantee new people.
Zero-based start of the FILTERS purchase window in the live query results. Omitted means zero at the backend. startOffset + count must not exceed the search schema's limits.resultCeiling (10000). SELECTED permits only omitted or zero. Live ordering can change between purchases; skipped rows are not bought and the offset does not guarantee new people.
SELECTED: providerId values from preview, 1 to 100; a repeated id counts once. Omit for FILTERS: they do not limit, exclude, or add query matches. If supplied, the array still must pass input validation.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Extrovert API","colors":{"primary":"#0D9373","light":"#07C983","dark":"#0D9373"},"logo":{"light":"https://mintcdn.com/extrovert/uYsKpcnAiaTjvYPb/favicon.svg?fit=max\u0026auto=format\u0026n=uYsKpcnAiaTjvYPb\u0026q=85\u0026s=4108a4e6311b5528ff0f41ae91220d07","dark":"https://mintcdn.com/extrovert/uYsKpcnAiaTjvYPb/favicon.svg?fit=max\u0026auto=format\u0026n=uYsKpcnAiaTjvYPb\u0026q=85\u0026s=4108a4e6311b5528ff0f41ae91220d07"},"favicon":"https://mintcdn.com/extrovert/uYsKpcnAiaTjvYPb/favicon.svg?fit=max\u0026auto=format\u0026n=uYsKpcnAiaTjvYPb\u0026q=85\u0026s=4108a4e6311b5528ff0f41ae91220d07","api":{"playground":{"display":"interactive"},"mdx":{"auth":{"method":"key","name":"x-api-key"}}},"navbar":{"links":[{"href":"https://www.goextrovert.com/","label":"Website"},{"href":"https://docs.goextrovert.com/en/","label":"Knowledge Base"},{"href":"mailto:support@goextrovert.com","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.goextrovert.com"}},"footer":{"socials":{}},"contextual":{"options":["copy","view","chatgpt","claude","mcp","add-mcp","cursor","vscode","download-spec"],"display":"header"},"variables":{"version":"0.0.063-feeaac6d"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"extrovert","hasAudioNarration":false,"actualSubdomain":"extrovert","customDomains":["api-docs.goextrovert.com"],"gitSource":{"type":"github","owner":"extrovertapp","repo":"public-api-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6af069a02ab4a0cc3d7efcd7","clientVersion":"0.0.4087","searchFilterCounts":[{"language":"default","tag":"API Reference","count":114},{"language":"default","tag":"Prospects","count":17},{"language":"default","tag":"Direct Messages","count":12},{"language":"default","tag":"Campaigns","count":11},{"language":"default","tag":"Comments","count":11},{"language":"default","tag":"Lead Finder","count":7},{"language":"default","tag":"Voices","count":6},{"language":"default","tag":"Account Settings","count":5},{"language":"default","tag":"Voice Comment Examples","count":5},{"language":"default","tag":"Voice DM Templates","count":5}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","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},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/lead-finder/import-prospects","slug":"/api-reference/lead-finder/import-prospects","pageMetadata":{"title":"Import Prospects","description":"Starts a paid import of prospects into a prospect list of a campaign. `FILTERS` buys `count` live matches of the same `query` starting at zero-based `startOffset` (default 0); `startOffset + count` must not exceed `limits.resultCeiling`. Skipped rows are not retrieved or charged. `SELECTED` permits only omitted or zero offset. Live ordering can shift; no unique or new prospects are guaranteed. After a completed import, the next window starts at its accepted `startOffset + breakdown.processed`, not `added`. A failed or cancelled purchase is not an automatic continuation. The charge is per prospect retrieved, not per prospect added: each retrieved prospect costs 1 credit, including prospects that end up not added (already in prospects, invalid, or over Prospect Capacity). The response comes as soon as the import is accepted, with three ids: the import, the campaign and the list (the new list when `listName` was given).\n\nThe start is refused, and nothing is created or charged:\n- `400`: The request is refused: its query as the preview refuses it (named by its path such as `query.filters[0].values` and, where known, its field and op), a campaign that is not a Prospects campaign (`TARGET_USER`), a list of another campaign, a count above the Prospect Capacity left or the search schema's `limits.resultCeiling`, a balance that does not cover the cost, or a cost that could exceed `maxCreditsSpend`.\n- `403`: The caller cannot update the campaign, the plan is inactive or cannot spend credits, or the `idempotencyKey` belongs to another workspace, user or API key.\n- `404`: The campaign or the list does not exist.\n- `409`: Another import of the campaign owner is still running; wait until it ends, then start again.\n\nOne `idempotencyKey` names one purchase: a retry with the same key returns the original purchase with `replayed: true`; its `campaignId` and `listId` may differ from this request; nothing new is started or charged. After a timeout, a network error, a 5xx or a 408, retry with the same key, since the purchase may already exist under it; after a 429, wait for `Retry-After` and retry with the same key. A 403 saying the `idempotencyKey` belongs to another workspace, user or API key means the key already names a purchase made by another caller: it is not proof that nothing was bought, so retry only with the same API key or user that made it. Any other 4xx means no purchase was created, and a new purchase takes a new key. The result — prospects added and credits charged — is not part of this response; it can be read by the import id once the import ends.","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json post /client/v2/lead-finder/imports","href":"/api-reference/lead-finder/import-prospects","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 li: \"li\",\n p: \"p\",\n ul: \"ul\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [\"Starts a paid import of prospects into a prospect list of a campaign. \", _jsx(_components.code, {\n children: \"FILTERS\"\n }), \" buys \", _jsx(_components.code, {\n children: \"count\"\n }), \" live matches of the same \", _jsx(_components.code, {\n children: \"query\"\n }), \" starting at zero-based \", _jsx(_components.code, {\n children: \"startOffset\"\n }), \" (default 0); \", _jsx(_components.code, {\n children: \"startOffset + count\"\n }), \" must not exceed \", _jsx(_components.code, {\n children: \"limits.resultCeiling\"\n }), \". Skipped rows are not retrieved or charged. \", _jsx(_components.code, {\n children: \"SELECTED\"\n }), \" permits only omitted or zero offset. Live ordering can shift; no unique or new prospects are guaranteed. After a completed import, the next window starts at its accepted \", _jsx(_components.code, {\n children: \"startOffset + breakdown.processed\"\n }), \", not \", _jsx(_components.code, {\n children: \"added\"\n }), \". A failed or cancelled purchase is not an automatic continuation. The charge is per prospect retrieved, not per prospect added: each retrieved prospect costs 1 credit, including prospects that end up not added (already in prospects, invalid, or over Prospect Capacity). The response comes as soon as the import is accepted, with three ids: the import, the campaign and the list (the new list when \", _jsx(_components.code, {\n children: \"listName\"\n }), \" was given).\"]\n }), \"\\n\", _jsx(_components.p, {\n children: \"The start is refused, and nothing is created or charged:\"\n }), \"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"400\"\n }), \": The request is refused: its query as the preview refuses it (named by its path such as \", _jsx(_components.code, {\n children: \"query.filters[0].values\"\n }), \" and, where known, its field and op), a campaign that is not a Prospects campaign (\", _jsx(_components.code, {\n children: \"TARGET_USER\"\n }), \"), a list of another campaign, a count above the Prospect Capacity left or the search schema’s \", _jsx(_components.code, {\n children: \"limits.resultCeiling\"\n }), \", a balance that does not cover the cost, or a cost that could exceed \", _jsx(_components.code, {\n children: \"maxCreditsSpend\"\n }), \".\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"403\"\n }), \": The caller cannot update the campaign, the plan is inactive or cannot spend credits, or the \", _jsx(_components.code, {\n children: \"idempotencyKey\"\n }), \" belongs to another workspace, user or API key.\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"404\"\n }), \": The campaign or the list does not exist.\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"409\"\n }), \": Another import of the campaign owner is still running; wait until it ends, then start again.\"]\n }), \"\\n\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"One \", _jsx(_components.code, {\n children: \"idempotencyKey\"\n }), \" names one purchase: a retry with the same key returns the original purchase with \", _jsx(_components.code, {\n children: \"replayed: true\"\n }), \"; its \", _jsx(_components.code, {\n children: \"campaignId\"\n }), \" and \", _jsx(_components.code, {\n children: \"listId\"\n }), \" may differ from this request; nothing new is started or charged. After a timeout, a network error, a 5xx or a 408, retry with the same key, since the purchase may already exist under it; after a 429, wait for \", _jsx(_components.code, {\n children: \"Retry-After\"\n }), \" and retry with the same key. A 403 saying the \", _jsx(_components.code, {\n children: \"idempotencyKey\"\n }), \" belongs to another workspace, user or API key means the key already names a purchase made by another caller: it is not proof that nothing was bought, so retry only with the same API key or user that made it. Any other 4xx means no purchase was created, and a new purchase takes a new key. The result — prospects added and credits charged — is not part of this response; it can be read by the import id once the import ends.\"]\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":"Import Prospects","description":"Starts a paid import of prospects into a prospect list of a campaign. `FILTERS` buys `count` live matches of the same `query` starting at zero-based `startOffset` (default 0); `startOffset + count` must not exceed `limits.resultCeiling`. Skipped rows are not retrieved or charged. `SELECTED` permits only omitted or zero offset. Live ordering can shift; no unique or new prospects are guaranteed. After a completed import, the next window starts at its accepted `startOffset + breakdown.processed`, not `added`. A failed or cancelled purchase is not an automatic continuation. The charge is per prospect retrieved, not per prospect added: each retrieved prospect costs 1 credit, including prospects that end up not added (already in prospects, invalid, or over Prospect Capacity). The response comes as soon as the import is accepted, with three ids: the import, the campaign and the list (the new list when `listName` was given).\n\nThe start is refused, and nothing is created or charged:\n- `400`: The request is refused: its query as the preview refuses it (named by its path such as `query.filters[0].values` and, where known, its field and op), a campaign that is not a Prospects campaign (`TARGET_USER`), a list of another campaign, a count above the Prospect Capacity left or the search schema's `limits.resultCeiling`, a balance that does not cover the cost, or a cost that could exceed `maxCreditsSpend`.\n- `403`: The caller cannot update the campaign, the plan is inactive or cannot spend credits, or the `idempotencyKey` belongs to another workspace, user or API key.\n- `404`: The campaign or the list does not exist.\n- `409`: Another import of the campaign owner is still running; wait until it ends, then start again.\n\nOne `idempotencyKey` names one purchase: a retry with the same key returns the original purchase with `replayed: true`; its `campaignId` and `listId` may differ from this request; nothing new is started or charged. After a timeout, a network error, a 5xx or a 408, retry with the same key, since the purchase may already exist under it; after a 429, wait for `Retry-After` and retry with the same key. A 403 saying the `idempotencyKey` belongs to another workspace, user or API key means the key already names a purchase made by another caller: it is not proof that nothing was bought, so retry only with the same API key or user that made it. Any other 4xx means no purchase was created, and a new purchase takes a new key. The result — prospects added and credits charged — is not part of this response; it can be read by the import id once the import ends.","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json post /client/v2/lead-finder/imports","href":"/api-reference/lead-finder/import-prospects","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"LeadFinderClientApiController_importProspects","summary":"Import Prospects","description":"Starts a paid import of prospects into a prospect list of a campaign. `FILTERS` buys `count` live matches of the same `query` starting at zero-based `startOffset` (default 0); `startOffset + count` must not exceed `limits.resultCeiling`. Skipped rows are not retrieved or charged. `SELECTED` permits only omitted or zero offset. Live ordering can shift; no unique or new prospects are guaranteed. After a completed import, the next window starts at its accepted `startOffset + breakdown.processed`, not `added`. A failed or cancelled purchase is not an automatic continuation. The charge is per prospect retrieved, not per prospect added: each retrieved prospect costs 1 credit, including prospects that end up not added (already in prospects, invalid, or over Prospect Capacity). The response comes as soon as the import is accepted, with three ids: the import, the campaign and the list (the new list when `listName` was given).\n\nThe start is refused, and nothing is created or charged:\n- `400`: The request is refused: its query as the preview refuses it (named by its path such as `query.filters[0].values` and, where known, its field and op), a campaign that is not a Prospects campaign (`TARGET_USER`), a list of another campaign, a count above the Prospect Capacity left or the search schema's `limits.resultCeiling`, a balance that does not cover the cost, or a cost that could exceed `maxCreditsSpend`.\n- `403`: The caller cannot update the campaign, the plan is inactive or cannot spend credits, or the `idempotencyKey` belongs to another workspace, user or API key.\n- `404`: The campaign or the list does not exist.\n- `409`: Another import of the campaign owner is still running; wait until it ends, then start again.\n\nOne `idempotencyKey` names one purchase: a retry with the same key returns the original purchase with `replayed: true`; its `campaignId` and `listId` may differ from this request; nothing new is started or charged. After a timeout, a network error, a 5xx or a 408, retry with the same key, since the purchase may already exist under it; after a 429, wait for `Retry-After` and retry with the same key. A 403 saying the `idempotencyKey` belongs to another workspace, user or API key means the key already names a purchase made by another caller: it is not proof that nothing was bought, so retry only with the same API key or user that made it. Any other 4xx means no purchase was created, and a new purchase takes a new key. The result — prospects added and credits charged — is not part of this response; it can be read by the import id once the import ends.","parameters":[],"requestBody":"361a62d5-1c6b-4c83-8d17-99479da70202","responses":{"202":"771f1bb3-9e5d-4c36-8009-7ef2d66e7b67","400":"128a66b3-12b3-4200-8130-2b80aef96522","401":"91785a83-e69e-4ccf-ac99-56a5d9d30ba2","403":"48d409ee-2b8e-4ecd-9cea-771c8fbcea0f","404":"f329dbaf-5391-4844-b3ae-8d1b0e0fa85a","409":"6743b6d2-2238-4cc2-b876-7a425cfc56af"},"tags":["Lead Finder"],"security":["4c4079e5-b097-4472-a971-fe538491b80d"],"method":"post","type":"path","servers":["9bc8441d-5821-4a6d-87a8-5a99c8f55a2a"],"path":"/client/v2/lead-finder/imports","baseUrlOptions":["https://api.goextrovert.com/"],"title":"Import Prospects","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["mode","schemaVersion","destination","idempotencyKey","maxCreditsSpend"],"conditionallyRequiredProperties":{"query":[{"when":[[{"property":"mode","values":["FILTERS"],"matchesAbsent":true}]]}],"count":[{"when":[[{"property":"mode","values":["FILTERS"],"matchesAbsent":true}]]}],"providerIds":[{"when":[[{"property":"mode","values":["SELECTED"],"matchesAbsent":true}]]}]},"properties":{"mode":{"type":"string","enum":["FILTERS","SELECTED"],"description":"`FILTERS` requests `count` matches of `query` starting at `startOffset`, not a page of guaranteed unimported people; `SELECTED` uses distinct preview `providerIds`. Selected IDs not returned by the provider are skipped, so delivery is not guaranteed.","isRequired":true,"uniqueKey":"mode","typeLabel":"enum\u003cstring>"},"schemaVersion":{"type":"string","minLength":1,"description":"The `version` the search schema currently reports, e.g. `people.v1`. Any other value is refused.","examples":["people.v1"],"isRequired":true,"uniqueKey":"schemaVersion","typeLabel":"string"},"destination":{"oneOf":[{"type":"object","title":"Existing list","description":"Where the prospects land. Exactly one of `listId` and `listName` is set; the other is omitted or `null`.","required":["campaignId","moveOwnDuplicated","onlyRecentlyActive","listId"],"properties":{"listId":{"type":"string","description":"An existing prospect list of the campaign; omit it or send `null` when `listName` names a new one.","format":"uuid","isRequired":true,"uniqueKey":"destination.oneOf.0.listId","typeLabel":"string\u003cuuid>"},"campaignId":{"type":"string","format":"uuid","description":"Campaign whose prospect list receives the import. It must be a Prospects campaign (`TARGET_USER`); a campaign of any other type is refused. Campaigns are never created here.","isRequired":true,"uniqueKey":"destination.oneOf.0.campaignId","typeLabel":"string\u003cuuid>"},"moveOwnDuplicated":{"type":"boolean","description":"Move prospects the campaign owner already holds in another list into this one instead of leaving them where they are.","isRequired":true,"uniqueKey":"destination.oneOf.0.moveOwnDuplicated","typeLabel":"boolean"},"onlyRecentlyActive":{"type":"boolean","description":"Remove prospects with no LinkedIn post in the last 30 days once their posts are first collected, after the import. They are imported and charged like the others.","isRequired":true,"uniqueKey":"destination.oneOf.0.onlyRecentlyActive","typeLabel":"boolean"},"listName":{"type":"null","description":"Name of a new prospect list to create under the campaign; omit it or send `null` when `listId` names an existing one.","uniqueKey":"destination.oneOf.0.listName","typeLabel":"null"}},"isRequired":true,"uniqueKey":"destination.oneOf.0","typeLabel":"Existing list · object"},{"type":"object","title":"New list","description":"Where the prospects land. Exactly one of `listId` and `listName` is set; the other is omitted or `null`.","required":["campaignId","moveOwnDuplicated","onlyRecentlyActive","listName"],"properties":{"listName":{"type":"string","description":"Name of a new prospect list to create under the campaign; omit it or send `null` when `listId` names an existing one.","minLength":1,"isRequired":true,"uniqueKey":"destination.oneOf.1.listName","typeLabel":"string"},"campaignId":{"type":"string","format":"uuid","description":"Campaign whose prospect list receives the import. It must be a Prospects campaign (`TARGET_USER`); a campaign of any other type is refused. Campaigns are never created here.","isRequired":true,"uniqueKey":"destination.oneOf.1.campaignId","typeLabel":"string\u003cuuid>"},"moveOwnDuplicated":{"type":"boolean","description":"Move prospects the campaign owner already holds in another list into this one instead of leaving them where they are.","isRequired":true,"uniqueKey":"destination.oneOf.1.moveOwnDuplicated","typeLabel":"boolean"},"onlyRecentlyActive":{"type":"boolean","description":"Remove prospects with no LinkedIn post in the last 30 days once their posts are first collected, after the import. They are imported and charged like the others.","isRequired":true,"uniqueKey":"destination.oneOf.1.onlyRecentlyActive","typeLabel":"boolean"},"listId":{"type":"null","description":"An existing prospect list of the campaign; omit it or send `null` when `listName` names a new one.","uniqueKey":"destination.oneOf.1.listId","typeLabel":"null"}},"isRequired":true,"uniqueKey":"destination.oneOf.1","typeLabel":"New list · object"}],"isRequired":true,"uniqueKey":"destination","typeLabel":"Existing list · object | New list · object"},"idempotencyKey":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$","description":"A UUID v4 the caller generates for this purchase; reuse it only to retry the same purchase.","isRequired":true,"uniqueKey":"idempotencyKey","typeLabel":"string\u003cuuid>"},"maxCreditsSpend":{"type":"integer","minimum":0,"maximum":2147483647,"description":"The most credits this import may charge: `count` × 1 for `FILTERS`, the number of distinct `providerIds` × 1 for `SELECTED`; 1 credit per retrieved prospect. The start is refused when the cost could exceed it.","examples":[50],"isRequired":true,"uniqueKey":"maxCreditsSpend","typeLabel":"integer"},"query":{"type":"object","description":"`FILTERS` only: the people-search query, the flat list of conditions `{\"filters\":[…]}` in the grammar Get Lead Finder Search Schema publishes — the same query the preview took. Omit for `SELECTED`: it does not select or exclude people, although a supplied query still must pass the gateway’s input validation. A key the grammar does not accept is refused, naming it; no key is dropped silently.","examples":[{"filters":[{"field":"contact.titleLatest","op":"any.include","mode":"SMART","values":["head of sales","sales director"]},{"field":"contact.seniority","op":"any.include","values":["director","head","vp"]},{"field":"contact.location","op":"any.include","values":["Germany"]},{"field":"account.industries","op":"any.include","mode":"SMART","values":["software development"]},{"field":"account.employeeSize","op":"range","ranges":[{"start":51,"end":500}]}]}],"properties":{"filters":{"type":"array","items":{"type":"object","description":"One condition: `field`, `op` and the payload keys of the field's `control` (for example `mode` and `values`, `values`, `ranges`, `start`/`end`, `min`/`max`, `rows`). A key the control does not take is refused, naming it. `mode`: SMART also matches similar or related values. WORD matches the exact phrase, with extra words allowed before or after it. STRICT matches the complete field value, with no extra words. A `keyword_sources` condition puts `mode` on each `sources[]` entry instead.","required":["field","op"],"properties":{"field":{"type":"string","description":"The field the condition filters on: a `field` the search schema lists, e.g. `contact.seniority`.","examples":["contact.seniority","account.employeeSize"],"isRequired":true,"uniqueKey":"query.filters.items.[INDEX].field","typeLabel":"string"},"op":{"type":"string","description":"The operation: one of the `ops` the search schema lists for that field, e.g. `any.include` or `range`. `all.include`: requires every supplied value to match using the selected match mode; a value containing spaces remains one value.","examples":["any.include","range"],"isRequired":true,"uniqueKey":"query.filters.items.[INDEX].op","typeLabel":"string"}},"additionalProperties":{"oneOf":[{}],"uniqueKey":"query.filters.items.[INDEX].additionalProperties","typeLabel":"any"},"uniqueKey":"query.filters.items.[INDEX]","typeLabel":"object"},"description":"The conditions, combined with AND. Each `field` and `op` pair appears at most once, and its one condition holds all of its values.","isRequired":true,"uniqueKey":"query.filters","typeLabel":"object[]"}},"additionalProperties":false,"required":["filters"],"conditionalRequirements":[{"when":[[{"property":"mode","values":["FILTERS"],"matchesAbsent":true}]]}],"uniqueKey":"query","typeLabel":"object"},"count":{"type":"integer","description":"`FILTERS`: required number of matches to request from `startOffset` in the live query results. Omit for `SELECTED`: selection uses distinct `providerIds`, not `count`. If supplied, `count` still must pass the input type and bounds. A count above the Prospect Capacity left or above what the balance covers, or a window with `startOffset + count` above the search schema's `limits.resultCeiling`, is refused before anything starts; an import is never trimmed to fit. The import stops when matches run out and charges only what it retrieved. Previously imported people may appear in the window and are retrieved and charged again; live ordering can shift, so a later offset does not guarantee new people.","examples":[50],"minimum":1,"maximum":2147483647,"conditionalRequirements":[{"when":[[{"property":"mode","values":["FILTERS"],"matchesAbsent":true}]]}],"uniqueKey":"count","typeLabel":"integer"},"startOffset":{"type":"integer","description":"Zero-based start of the `FILTERS` purchase window in the live query results. Omitted means zero at the backend. `startOffset + count` must not exceed the search schema's `limits.resultCeiling` (10000). `SELECTED` permits only omitted or zero. Live ordering can change between purchases; skipped rows are not bought and the offset does not guarantee new people.","examples":[0,100],"minimum":0,"maximum":2147483647,"uniqueKey":"startOffset","typeLabel":"integer"},"providerIds":{"type":"array","description":"`SELECTED`: `providerId` values from preview, 1 to 100; a repeated id counts once. Omit for `FILTERS`: they do not limit, exclude, or add query matches. If supplied, the array still must pass input validation.","minItems":1,"maxItems":100,"items":{"type":"string","minLength":1,"uniqueKey":"providerIds.items.[INDEX]","typeLabel":"string"},"conditionalRequirements":[{"when":[[{"property":"mode","values":["SELECTED"],"matchesAbsent":true}]]}],"uniqueKey":"providerIds","typeLabel":"string[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"schemaVersion":"people.v1","destination":{"listId":"3c90c3cc-0d44-4b50-8888-8dd25736052a","campaignId":"3c90c3cc-0d44-4b50-8888-8dd25736052a","moveOwnDuplicated":true,"onlyRecentlyActive":true,"listName":null},"idempotencyKey":"3c90c3cc-0d44-4b50-8888-8dd25736052a","maxCreditsSpend":50,"query":{"filters":[{"field":"contact.titleLatest","op":"any.include","mode":"SMART","values":["head of sales","sales director"]},{"field":"contact.seniority","op":"any.include","values":["director","head","vp"]},{"field":"contact.location","op":"any.include","values":["Germany"]},{"field":"account.industries","op":"any.include","mode":"SMART","values":["software development"]},{"field":"account.employeeSize","op":"range","ranges":[{"start":51,"end":500}]}]},"count":50,"startOffset":0,"providerIds":["\u003cstring>"]}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"771f1bb3-9e5d-4c36-8009-7ef2d66e7b67":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status","isRequired":true,"uniqueKey":"status","typeLabel":"string"},"data":{"type":"object","properties":{"importId":{"type":"string","format":"uuid","description":"Id of the import this `idempotencyKey` names — the one just started, or, when `replayed` is `true`, the earlier one.","isRequired":true,"uniqueKey":"data.importId","typeLabel":"string\u003cuuid>"},"campaignId":{"type":"string","format":"uuid","description":"The destination campaign.","isRequired":true,"uniqueKey":"data.campaignId","typeLabel":"string\u003cuuid>"},"listId":{"type":"string","format":"uuid","description":"The destination prospect list — the existing one, or the one just created from `listName`.","isRequired":true,"uniqueKey":"data.listId","typeLabel":"string\u003cuuid>"},"idempotencyKey":{"type":"string","format":"uuid","description":"The `idempotencyKey` of the request, echoed.","isRequired":true,"uniqueKey":"data.idempotencyKey","typeLabel":"string\u003cuuid>"},"replayed":{"type":"boolean","description":"`true` when this key already named an import: the ids are that earlier import's and this call started, created or charged nothing. `false` when a fresh import was started.","isRequired":true,"uniqueKey":"data.replayed","typeLabel":"boolean"}},"required":["importId","campaignId","listId","idempotencyKey","replayed"],"isRequired":true,"uniqueKey":"data","typeLabel":"object"},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"],"isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["status","data","message"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"status":"success","data":{"importId":"3c90c3cc-0d44-4b50-8888-8dd25736052a","campaignId":"3c90c3cc-0d44-4b50-8888-8dd25736052a","listId":"3c90c3cc-0d44-4b50-8888-8dd25736052a","idempotencyKey":"3c90c3cc-0d44-4b50-8888-8dd25736052a","replayed":true},"message":"Operation completed successfully"}}},"exampleType":"generated"}},"exampleType":"generated"},"128a66b3-12b3-4200-8130-2b80aef96522":{"description":"The request is refused: its query as the preview refuses it (named by its path such as `query.filters[0].values` and, where known, its field and op), a campaign that is not a Prospects campaign (`TARGET_USER`), a list of another campaign, a count above the Prospect Capacity left or the search schema's `limits.resultCeiling`, a balance that does not cover the cost, or a cost that could exceed `maxCreditsSpend`.","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","description":"Response status","example":"error","enum":["error"],"isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"data":{"type":"null","description":"Response data","example":null,"isRequired":true,"uniqueKey":"data","typeLabel":"null"},"message":{"type":"string","description":"Error message","example":"An error occurred while processing the request","uniqueKey":"message","typeLabel":"string"}},"required":["status","data"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"status":"error","data":null,"message":"An error occurred while processing the request"}}},"exampleType":"generated"}},"exampleType":"generated"},"91785a83-e69e-4ccf-ac99-56a5d9d30ba2":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","description":"Response status","example":"error","enum":["error"],"isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"data":{"type":"null","description":"Response data","example":null,"isRequired":true,"uniqueKey":"data","typeLabel":"null"},"message":{"type":"string","description":"Error message","example":"An error occurred while processing the request","uniqueKey":"message","typeLabel":"string"}},"required":["status","data"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"status":"error","data":null,"message":"An error occurred while processing the request"}}},"exampleType":"generated"}},"exampleType":"generated"},"48d409ee-2b8e-4ecd-9cea-771c8fbcea0f":{"description":"The caller cannot update the campaign, the plan is inactive or cannot spend credits, or the `idempotencyKey` belongs to another workspace, user or API key.","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","description":"Response status","example":"error","enum":["error"],"isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"data":{"type":"null","description":"Response data","example":null,"isRequired":true,"uniqueKey":"data","typeLabel":"null"},"message":{"type":"string","description":"Error message","example":"An error occurred while processing the request","uniqueKey":"message","typeLabel":"string"}},"required":["status","data"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"status":"error","data":null,"message":"An error occurred while processing the request"}}},"exampleType":"generated"}},"exampleType":"generated"},"f329dbaf-5391-4844-b3ae-8d1b0e0fa85a":{"description":"The campaign or the list does not exist.","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","description":"Response status","example":"error","enum":["error"],"isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"data":{"type":"null","description":"Response data","example":null,"isRequired":true,"uniqueKey":"data","typeLabel":"null"},"message":{"type":"string","description":"Error message","example":"An error occurred while processing the request","uniqueKey":"message","typeLabel":"string"}},"required":["status","data"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"status":"error","data":null,"message":"An error occurred while processing the request"}}},"exampleType":"generated"}},"exampleType":"generated"},"6743b6d2-2238-4cc2-b876-7a425cfc56af":{"description":"Another import of the campaign owner is still running; wait until it ends, then start again.","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","description":"Response status","example":"error","enum":["error"],"isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"data":{"type":"null","description":"Response data","example":null,"isRequired":true,"uniqueKey":"data","typeLabel":"null"},"message":{"type":"string","description":"Error message","example":"An error occurred while processing the request","uniqueKey":"message","typeLabel":"string"}},"required":["status","data"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"status":"error","data":null,"message":"An error occurred while processing the request"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"4c4079e5-b097-4472-a971-fe538491b80d":{"api-key":{"type":"apiKey","in":"header","name":"X-API-Key","description":"API Key for authentication","scopes":[],"schemeName":"api-key"}}},"servers":{"9bc8441d-5821-4a6d-87a8-5a99c8f55a2a":{"url":"https://api.goextrovert.com/","description":"API Server"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-API-Key","description":"API Key for authentication","scopes":[],"schemeName":"api-key"},"schema":{"title":"X-API-Key","type":"string","description":"API Key for authentication","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"api-key","name":"X-API-Key"}],"title":"api-key"}]},"originalFileLocation":"https://api.goextrovert.com/client/v2/docs-json"},"subdomain":"extrovert","siteName":"Extrovert API","title":"Import Prospects - Extrovert API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-08T12:23:03.434Z","originalFileLocation":"api-reference/lead-finder/import-prospects.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=\"Starts a paid import of prospects into a prospect list of a campaign. FILTERS buys count live matches of the same query starting at zero-based startOffset (default 0); startOffset + count must not exceed limits.resultCeiling. Skipped rows are not retrieved or charged. SELECTED permits only omitted or zero offset. Live ordering can shift; no unique or new prospects are guaranteed. After a completed import, the next window starts at its accepted startOffset + breakdown.processed, not added. A failed or cancelled purchase is not an automatic continuation. The charge is per prospect retrieved, not per prospect added: each retrieved prospect costs 1 credit, including prospects that end up not added (already in prospects, invalid, or over Prospect Capacity). The response comes as soon as the import is accepted, with three ids: the import, the campaign and the list (the new list when listName was given). The start is refused, and nothing is created or charged: - 400: The request is refused: its query as the preview refuses it (named by its path such as query.filters[0].values and, where known, its field and op), a campaign that is not a Prospects campaign (TARGET_USER), a list of another campaign, a count above the Prospect Capacity left or the search schema\u0026#x27;s limits.resultCeiling, a balance that does not cover the cost, or a cost that could exceed maxCreditsSpend. - 403: The caller cannot update the campaign, the plan is inactive or cannot spend credits, or the idempotencyKey belongs to another workspace, user or API key. - 404: The campaign or the list does not exist. - 409: Another import of the campaign owner is still running; wait until it ends, then start again. One idempotencyKey names one purchase: a retry with the same key returns the original purchase with replayed: true; its campaignId and listId may differ from this request; nothing new is started or charged. After a timeout, a network error, a 5xx or a 408, retry with the same key, since the purchase may already exist under it; after a 429, wait for Retry-After and retry with the same key. A 403 saying the idempotencyKey belongs to another workspace, user or API key means the key already names a purchase made by another caller: it is not proof that nothing was bought, so retry only with the same API key or user that made it. Any other 4xx means no purchase was created, and a new purchase takes a new key. The result — prospects added and credits charged — is not part of this response; it can be read by the import id once the import ends.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Extrovert API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/extrovert/wBMHwBVq58j-UOlj/_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/extrovert/wBMHwBVq58j-UOlj/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/extrovert/wBMHwBVq58j-UOlj/_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/extrovert/wBMHwBVq58j-UOlj/_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/extrovert/wBMHwBVq58j-UOlj/_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/extrovert/wBMHwBVq58j-UOlj/_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/extrovert/wBMHwBVq58j-UOlj/_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/extrovert/wBMHwBVq58j-UOlj/_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/extrovert/wBMHwBVq58j-UOlj/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Import Prospects - Extrovert API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Starts a paid import of prospects into a prospect list of a campaign. FILTERS buys count live matches of the same query starting at zero-based startOffset (default 0); startOffset + count must not exceed limits.resultCeiling. Skipped rows are not retrieved or charged. SELECTED permits only omitted or zero offset. Live ordering can shift; no unique or new prospects are guaranteed. After a completed import, the next window starts at its accepted startOffset + breakdown.processed, not added. A failed or cancelled purchase is not an automatic continuation. The charge is per prospect retrieved, not per prospect added: each retrieved prospect costs 1 credit, including prospects that end up not added (already in prospects, invalid, or over Prospect Capacity). The response comes as soon as the import is accepted, with three ids: the import, the campaign and the list (the new list when listName was given). The start is refused, and nothing is created or charged: - 400: The request is refused: its query as the preview refuses it (named by its path such as query.filters[0].values and, where known, its field and op), a campaign that is not a Prospects campaign (TARGET_USER), a list of another campaign, a count above the Prospect Capacity left or the search schema\u0026#x27;s limits.resultCeiling, a balance that does not cover the cost, or a cost that could exceed maxCreditsSpend. - 403: The caller cannot update the campaign, the plan is inactive or cannot spend credits, or the idempotencyKey belongs to another workspace, user or API key. - 404: The campaign or the list does not exist. - 409: Another import of the campaign owner is still running; wait until it ends, then start again. One idempotencyKey names one purchase: a retry with the same key returns the original purchase with replayed: true; its campaignId and listId may differ from this request; nothing new is started or charged. After a timeout, a network error, a 5xx or a 408, retry with the same key, since the purchase may already exist under it; after a 429, wait for Retry-After and retry with the same key. A 403 saying the idempotencyKey belongs to another workspace, user or API key means the key already names a purchase made by another caller: it is not proof that nothing was bought, so retry only with the same API key or user that made it. Any other 4xx means no purchase was created, and a new purchase takes a new key. The result — prospects added and credits charged — is not part of this response; it can be read by the import id once the import ends.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Extrovert API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://api-docs.goextrovert.com/api-reference/lead-finder/import-prospects\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://extrovert.mintlify.site/_mintlify/api/og/v2?division=Lead+Finder\u0026amp;title=Import+Prospects\u0026amp;description=Starts+a+paid+import+of+prospects+into+a+prospect+list+of+a+campaign.+%60FILTERS%60+buys+%60count%60+live+matches+of+the+same+%60query%60+starting+at+zero-based+%60startOffse\u0026amp;theme=7fb59e3f4dcb9df5a7ac876c\u0026amp;signature=d0d14626d3babd40867f6b758d69d5c4f1c33487256133faeab695ac0160a961\">\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=\"Import Prospects - Extrovert API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Starts a paid import of prospects into a prospect list of a campaign. FILTERS buys count live matches of the same query starting at zero-based startOffset (default 0); startOffset + count must not exceed limits.resultCeiling. Skipped rows are not retrieved or charged. SELECTED permits only omitted or zero offset. Live ordering can shift; no unique or new prospects are guaranteed. After a completed import, the next window starts at its accepted startOffset + breakdown.processed, not added. A failed or cancelled purchase is not an automatic continuation. The charge is per prospect retrieved, not per prospect added: each retrieved prospect costs 1 credit, including prospects that end up not added (already in prospects, invalid, or over Prospect Capacity). The response comes as soon as the import is accepted, with three ids: the import, the campaign and the list (the new list when listName was given). The start is refused, and nothing is created or charged: - 400: The request is refused: its query as the preview refuses it (named by its path such as query.filters[0].values and, where known, its field and op), a campaign that is not a Prospects campaign (TARGET_USER), a list of another campaign, a count above the Prospect Capacity left or the search schema\u0026#x27;s limits.resultCeiling, a balance that does not cover the cost, or a cost that could exceed maxCreditsSpend. - 403: The caller cannot update the campaign, the plan is inactive or cannot spend credits, or the idempotencyKey belongs to another workspace, user or API key. - 404: The campaign or the list does not exist. - 409: Another import of the campaign owner is still running; wait until it ends, then start again. One idempotencyKey names one purchase: a retry with the same key returns the original purchase with replayed: true; its campaignId and listId may differ from this request; nothing new is started or charged. After a timeout, a network error, a 5xx or a 408, retry with the same key, since the purchase may already exist under it; after a 429, wait for Retry-After and retry with the same key. A 403 saying the idempotencyKey belongs to another workspace, user or API key means the key already names a purchase made by another caller: it is not proof that nothing was bought, so retry only with the same API key or user that made it. Any other 4xx means no purchase was created, and a new purchase takes a new key. The result — prospects added and credits charged — is not part of this response; it can be read by the import id once the import ends.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://extrovert.mintlify.site/_mintlify/api/og/v2?division=Lead+Finder\u0026amp;title=Import+Prospects\u0026amp;description=Starts+a+paid+import+of+prospects+into+a+prospect+list+of+a+campaign.+%60FILTERS%60+buys+%60count%60+live+matches+of+the+same+%60query%60+starting+at+zero-based+%60startOffse\u0026amp;theme=7fb59e3f4dcb9df5a7ac876c\u0026amp;signature=d0d14626d3babd40867f6b758d69d5c4f1c33487256133faeab695ac0160a961\">\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/extrovert/wBMHwBVq58j-UOlj/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Extrovert API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0D9373\">\u003clink data-mint-head rel=\"canonical\" href=\"https://api-docs.goextrovert.com/api-reference/lead-finder/import-prospects\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/lead-finder/import-prospects.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://api-docs.goextrovert.com/#organization\",\"name\":\"Extrovert API\",\"url\":\"https://api-docs.goextrovert.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/extrovert/uYsKpcnAiaTjvYPb/favicon.svg?fit=max\u0026auto=format\u0026n=uYsKpcnAiaTjvYPb\u0026q=85\u0026s=4108a4e6311b5528ff0f41ae91220d07\"}},{\"@type\":\"WebSite\",\"@id\":\"https://api-docs.goextrovert.com#website\",\"name\":\"Extrovert API\",\"url\":\"https://api-docs.goextrovert.com\",\"publisher\":{\"@id\":\"https://api-docs.goextrovert.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://api-docs.goextrovert.com/api-reference/lead-finder/import-prospects#webpage\",\"url\":\"https://api-docs.goextrovert.com/api-reference/lead-finder/import-prospects\",\"name\":\"Import Prospects\",\"description\":\"Starts a paid import of prospects into a prospect list of a campaign. FILTERS buys count live matches of the same query starting at zero-based startOffset (default 0); startOffset + count must not exceed limits.resultCeiling. Skipped rows are not retrieved or charged. SELECTED permits only omitted or zero offset. Live ordering can shift; no unique or new prospects are guaranteed. After a completed import, the next window starts at its accepted startOffset + breakdown.processed, not added. A failed or cancelled purchase is not an automatic continuation. The charge is per prospect retrieved, not per prospect added: each retrieved prospect costs 1 credit, including prospects that end up not added (already in prospects, invalid, or over Prospect Capacity). The response comes as soon as the import is accepted, with three ids: the import, the campaign and the list (the new list when listName was given). The start is refused, and nothing is created or charged: - 400: The request is refused: its query as the preview refuses it (named by its path such as query.filters[0].values and, where known, its field and op), a campaign that is not a Prospects campaign (TARGET_USER), a list of another campaign, a count above the Prospect Capacity left or the search schema's limits.resultCeiling, a balance that does not cover the cost, or a cost that could exceed maxCreditsSpend. - 403: The caller cannot update the campaign, the plan is inactive or cannot spend credits, or the idempotencyKey belongs to another workspace, user or API key. - 404: The campaign or the list does not exist. - 409: Another import of the campaign owner is still running; wait until it ends, then start again. One idempotencyKey names one purchase: a retry with the same key returns the original purchase with replayed: true; its campaignId and listId may differ from this request; nothing new is started or charged. After a timeout, a network error, a 5xx or a 408, retry with the same key, since the purchase may already exist under it; after a 429, wait for Retry-After and retry with the same key. A 403 saying the idempotencyKey belongs to another workspace, user or API key means the key already names a purchase made by another caller: it is not proof that nothing was bought, so retry only with the same API key or user that made it. Any other 4xx means no purchase was created, and a new purchase takes a new key. The result — prospects added and credits charged — is not part of this response; it can be read by the import id once the import ends.\",\"dateModified\":\"2026-11-08T12:23:03.434Z\",\"isPartOf\":{\"@id\":\"https://api-docs.goextrovert.com#website\"},\"breadcrumb\":{\"@id\":\"https://api-docs.goextrovert.com/api-reference/lead-finder/import-prospects#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://api-docs.goextrovert.com/api-reference/lead-finder/import-prospects#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Lead Finder\",\"item\":\"https://api-docs.goextrovert.com/api-reference/lead-finder/get-search-schema\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Import Prospects\",\"item\":\"https://api-docs.goextrovert.com/api-reference/lead-finder/import-prospects\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://api-docs.goextrovert.com/api-reference/lead-finder/import-prospects#apireference\",\"headline\":\"Import Prospects\",\"name\":\"Import Prospects\",\"description\":\"Starts a paid import of prospects into a prospect list of a campaign. FILTERS buys count live matches of the same query starting at zero-based startOffset (default 0); startOffset + count must not exceed limits.resultCeiling. Skipped rows are not retrieved or charged. SELECTED permits only omitted or zero offset. Live ordering can shift; no unique or new prospects are guaranteed. After a completed import, the next window starts at its accepted startOffset + breakdown.processed, not added. A failed or cancelled purchase is not an automatic continuation. The charge is per prospect retrieved, not per prospect added: each retrieved prospect costs 1 credit, including prospects that end up not added (already in prospects, invalid, or over Prospect Capacity). The response comes as soon as the import is accepted, with three ids: the import, the campaign and the list (the new list when listName was given). The start is refused, and nothing is created or charged: - 400: The request is refused: its query as the preview refuses it (named by its path such as query.filters[0].values and, where known, its field and op), a campaign that is not a Prospects campaign (TARGET_USER), a list of another campaign, a count above the Prospect Capacity left or the search schema's limits.resultCeiling, a balance that does not cover the cost, or a cost that could exceed maxCreditsSpend. - 403: The caller cannot update the campaign, the plan is inactive or cannot spend credits, or the idempotencyKey belongs to another workspace, user or API key. - 404: The campaign or the list does not exist. - 409: Another import of the campaign owner is still running; wait until it ends, then start again. One idempotencyKey names one purchase: a retry with the same key returns the original purchase with replayed: true; its campaignId and listId may differ from this request; nothing new is started or charged. After a timeout, a network error, a 5xx or a 408, retry with the same key, since the purchase may already exist under it; after a 429, wait for Retry-After and retry with the same key. A 403 saying the idempotencyKey belongs to another workspace, user or API key means the key already names a purchase made by another caller: it is not proof that nothing was bought, so retry only with the same API key or user that made it. Any other 4xx means no purchase was created, and a new purchase takes a new key. The result — prospects added and credits charged — is not part of this response; it can be read by the import id once the import ends.\",\"url\":\"https://api-docs.goextrovert.com/api-reference/lead-finder/import-prospects\",\"mainEntityOfPage\":{\"@id\":\"https://api-docs.goextrovert.com/api-reference/lead-finder/import-prospects#webpage\"},\"dateModified\":\"2026-11-08T12:23:03.434Z\",\"publisher\":{\"@id\":\"https://api-docs.goextrovert.com/#organization\"},\"isPartOf\":{\"@id\":\"https://api-docs.goextrovert.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Extrovert API\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Extrovert API","nav":{"global":null,"tabs":[{"tab":"API Reference","groups":[{"group":"Integration Methods","pages":[{"title":"REST API","href":"/api-reference/introduction"},{"title":"Webhooks","href":"/api-reference/webhooks"}]},{"group":"Team Members","pages":[{"title":"List Team Members","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json get /client/v2/user/team-members","href":"/api-reference/team-members/list-team-members"}]},{"group":"Account Settings","pages":[{"title":"Get LinkedIn Connection Status","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json get /client/v2/account-settings/{ownerId}/linkedin-status","href":"/api-reference/account-settings/get-linkedin-connection-status"},{"title":"Get Daily Limits","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json get /client/v2/account-settings/{ownerId}/daily-limits","href":"/api-reference/account-settings/get-daily-limits"},{"title":"Update Daily Limits","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json put /client/v2/account-settings/{ownerId}/daily-limits","href":"/api-reference/account-settings/update-daily-limits"},{"title":"Get Working Hours","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json get /client/v2/account-settings/{ownerId}/working-hours","href":"/api-reference/account-settings/get-working-hours"},{"title":"Update Working Hours","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json put /client/v2/account-settings/{ownerId}/working-hours","href":"/api-reference/account-settings/update-working-hours"}]},{"group":"Workspace","pages":[{"title":"Get Current Workspace Plan Features","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json get /client/v2/workspace/get-current-plan-features","href":"/api-reference/workspace/get-current-workspace-plan-features"},{"title":"Get Workspace Capacity","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json get /client/v2/workspace/get-capacity","href":"/api-reference/workspace/get-workspace-capacity"}]},{"group":"Dashboard","pages":[{"title":"Get Dashboard Commenting Statistics","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json get /client/v2/dashboard/commenting","href":"/api-reference/dashboard/get-dashboard-commenting-statistics"},{"title":"Get Dashboard Connection Statistics","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json get /client/v2/dashboard/connections","href":"/api-reference/dashboard/get-dashboard-connection-statistics"},{"title":"Get Dashboard Direct Message Statistics","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json get /client/v2/dashboard/direct-messages","href":"/api-reference/dashboard/get-dashboard-direct-message-statistics"}]},{"group":"CSV Export","pages":[{"title":"Download CSV Export","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json get /client/v2/csv-export","href":"/api-reference/csv-export/download-csv-export"}]},{"group":"Prospects","pages":[{"title":"List Prospect Lists on Campaign","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json get /client/v2/prospect-list/get-campaign-lists","href":"/api-reference/prospects/list-prospect-lists-on-campaign"},{"title":"Get Prospect List","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json get /client/v2/prospect-list/{id}","href":"/api-reference/prospects/get-prospect-list"},{"title":"Update Prospect List","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json patch /client/v2/prospect-list/{id}","href":"/api-reference/prospects/update-prospect-list"},{"title":"Create prospect list with LinkedIn profile URLs","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json post /client/v2/prospect-list","href":"/api-reference/prospects/create-prospect-list-with-linkedin-profile-urls"},{"title":"Create Empty Prospect List","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json post /client/v2/prospect-list/create-empty-list","href":"/api-reference/prospects/create-empty-prospect-list"},{"title":"Count Inactive Prospects","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json post /client/v2/prospect-list/count-inactive","href":"/api-reference/prospects/count-inactive-prospects"},{"title":"Delete Inactive Prospects","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json post /client/v2/prospect-list/delete-inactive","href":"/api-reference/prospects/delete-inactive-prospects"},{"title":"Add LinkedIn profile URLs to an existing prospect list","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json post /client/v2/prospect-list/{id}/add-users-to-list","href":"/api-reference/prospects/add-linkedin-profile-urls-to-an-existing-prospect-list"},{"title":"Delete Prospect List","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json post /client/v2/prospect-list/{id}/delete","href":"/api-reference/prospects/delete-prospect-list"},{"title":"Replace Prospect Notes","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json post /client/v2/prospects/{id}/replace-notes","href":"/api-reference/prospects/replace-prospect-notes"},{"title":"Add Prospect Note Fact","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json post /client/v2/prospects/{id}/add-note-fact","href":"/api-reference/prospects/add-prospect-note-fact"},{"title":"List Prospects","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json get /client/v2/prospects","href":"/api-reference/prospects/list-prospects"},{"title":"Find Prospect By LinkedIn URL","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json get /client/v2/prospects/find-by-linkedin-url","href":"/api-reference/prospects/find-prospect-by-linkedin-url"},{"title":"Get Prospect","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json get /client/v2/prospects/{id}","href":"/api-reference/prospects/get-prospect"},{"title":"Delete Selected Prospects","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json post /client/v2/prospects/delete-selected","href":"/api-reference/prospects/delete-selected-prospects"},{"title":"Move Selected Prospects","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json post /client/v2/prospects/move","href":"/api-reference/prospects/move-selected-prospects"},{"title":"Mark Prospect As Important","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json post /client/v2/prospects/{id}/mark-important","href":"/api-reference/prospects/mark-prospect-as-important"}]},{"group":"Prospects (legacy)","pages":[{"title":"List Prospects With Statistics","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json get /api/client/v1/prospects","href":"/api-reference/prospects-legacy/list-prospects-with-statistics"},{"title":"Add Prospect","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json post /api/client/v1/prospects","href":"/api-reference/prospects-legacy/add-prospect"},{"title":"Remove Prospect From Campaign","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json delete /api/client/v1/prospects","href":"/api-reference/prospects-legacy/remove-prospect-from-campaign"},{"title":"Remove Prospect From Team","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json delete /api/client/v1/workspace/prospects","href":"/api-reference/prospects-legacy/remove-prospect-from-team"}]},{"group":"Comments","pages":[{"title":"List comments","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json get /client/v2/comments","href":"/api-reference/comments/list-comments"},{"title":"Get comment","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json get /client/v2/comments/{postId}","href":"/api-reference/comments/get-comment"},{"title":"Generate or improve comment draft","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json post /client/v2/comments/{postId}/generate-or-improve-draft","href":"/api-reference/comments/generate-or-improve-comment-draft"},{"title":"Generate comment drafts","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json post /client/v2/comments/generate-drafts","href":"/api-reference/comments/generate-comment-drafts"},{"title":"Set comment draft text","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json patch /client/v2/comments/{postId}/draft","href":"/api-reference/comments/set-comment-draft-text"},{"title":"Skip comment and react","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json post /client/v2/comments/{postId}/skip-and-react","href":"/api-reference/comments/skip-comment-and-react"},{"title":"Approve comment","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json post /client/v2/comments/{postId}/approve","href":"/api-reference/comments/approve-comment"},{"title":"Bulk approve comments","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json post /client/v2/comments/bulk-approve","href":"/api-reference/comments/bulk-approve-comments"},{"title":"Cancel comment posting","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json post /client/v2/comments/{postId}/cancel-posting","href":"/api-reference/comments/cancel-comment-posting"},{"title":"Skip comment","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json post /client/v2/comments/{postId}/skip","href":"/api-reference/comments/skip-comment"},{"title":"Unskip comment","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json post /client/v2/comments/{postId}/unskip","href":"/api-reference/comments/unskip-comment"}]},{"group":"Main Feed","pages":[{"title":"List Main Feed comments","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json get /client/v2/main-feed","href":"/api-reference/main-feed/list-main-feed-comments"}]},{"group":"Comment Today","pages":[{"title":"Get Comment Today State","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json get /client/v2/comment-today/{id}","href":"/api-reference/comment-today/get-comment-today-state"},{"title":"Set Comment Today Goal","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json patch /client/v2/comment-today/{id}/set-goal","href":"/api-reference/comment-today/set-comment-today-goal"}]},{"group":"Voice Comment Examples","pages":[{"title":"List Comment Examples on a Voice","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json get /client/v2/voice-comment-examples","href":"/api-reference/voice-comment-examples/list-comment-examples-on-a-voice"},{"title":"Create Comment Examples","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json post /client/v2/voice-comment-examples","href":"/api-reference/voice-comment-examples/create-comment-examples"},{"title":"Delete Comment Examples","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json delete /client/v2/voice-comment-examples","href":"/api-reference/voice-comment-examples/delete-comment-examples"},{"title":"Update Comment Examples","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json patch /client/v2/voice-comment-examples","href":"/api-reference/voice-comment-examples/update-comment-examples"},{"title":"Get Comment Example","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json get /client/v2/voice-comment-examples/{id}","href":"/api-reference/voice-comment-examples/get-comment-example"}]},{"group":"Monitored Topics","pages":[{"title":"List Monitored Topics","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json get /client/v2/monitored-topics","href":"/api-reference/monitored-topics/list-monitored-topics"},{"title":"Create Monitored Topics","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json post /client/v2/monitored-topics","href":"/api-reference/monitored-topics/create-monitored-topics"},{"title":"Delete Monitored Topics","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json delete /client/v2/monitored-topics","href":"/api-reference/monitored-topics/delete-monitored-topics"},{"title":"Update Monitored Topics","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json patch /client/v2/monitored-topics","href":"/api-reference/monitored-topics/update-monitored-topics"}]},{"group":"Campaign Topics","pages":[{"title":"List Monitored Topic Bindings on a Topic Campaign","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json get /client/v2/campaign-topic","href":"/api-reference/campaign-topics/list-monitored-topic-bindings-on-a-topic-campaign"},{"title":"Replace Monitored Topic Bindings on a Topic Campaign","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json post /client/v2/campaign-topic/{campaignId}/toggle-bulk","href":"/api-reference/campaign-topics/replace-monitored-topic-bindings-on-a-topic-campaign"}]},{"group":"Voice Talking Points","pages":[{"title":"List Talking Points on a Voice","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json get /client/v2/voice-talking-points","href":"/api-reference/voice-talking-points/list-talking-points-on-a-voice"},{"title":"Create Talking Points","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json post /client/v2/voice-talking-points","href":"/api-reference/voice-talking-points/create-talking-points"},{"title":"Delete Talking Points","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json delete /client/v2/voice-talking-points","href":"/api-reference/voice-talking-points/delete-talking-points"},{"title":"Update Talking Points","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json patch /client/v2/voice-talking-points","href":"/api-reference/voice-talking-points/update-talking-points"},{"title":"Get Talking Point","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json get /client/v2/voice-talking-points/{id}","href":"/api-reference/voice-talking-points/get-talking-point"}]},{"group":"Voice Selling Points","pages":[{"title":"List Selling Points on a Voice","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json get /client/v2/voice-selling-points","href":"/api-reference/voice-selling-points/list-selling-points-on-a-voice"},{"title":"Create Selling Points","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json post /client/v2/voice-selling-points","href":"/api-reference/voice-selling-points/create-selling-points"},{"title":"Delete Selling Points","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json delete /client/v2/voice-selling-points","href":"/api-reference/voice-selling-points/delete-selling-points"},{"title":"Update Selling Points","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json patch /client/v2/voice-selling-points","href":"/api-reference/voice-selling-points/update-selling-points"},{"title":"Get Selling Point","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json get /client/v2/voice-selling-points/{id}","href":"/api-reference/voice-selling-points/get-selling-point"}]},{"group":"Voice DM Templates","pages":[{"title":"List DM Templates on a Voice","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json get /client/v2/voice-dm-templates","href":"/api-reference/voice-dm-templates/list-dm-templates-on-a-voice"},{"title":"Create DM Templates","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json post /client/v2/voice-dm-templates","href":"/api-reference/voice-dm-templates/create-dm-templates"},{"title":"Delete DM Templates","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json delete /client/v2/voice-dm-templates","href":"/api-reference/voice-dm-templates/delete-dm-templates"},{"title":"Update DM Templates","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json patch /client/v2/voice-dm-templates","href":"/api-reference/voice-dm-templates/update-dm-templates"},{"title":"Get DM Template","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json get /client/v2/voice-dm-templates/{id}","href":"/api-reference/voice-dm-templates/get-dm-template"}]},{"group":"Campaigns","pages":[{"title":"List Campaigns","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json get /client/v2/campaign","href":"/api-reference/campaigns/list-campaigns"},{"title":"Create Campaign","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json post /client/v2/campaign","href":"/api-reference/campaigns/create-campaign"},{"title":"Get Campaign","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json get /client/v2/campaign/{id}","href":"/api-reference/campaigns/get-campaign"},{"title":"Update Campaign","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json patch /client/v2/campaign/{id}","href":"/api-reference/campaigns/update-campaign"},{"title":"Update Automatic Comments Settings","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json patch /client/v2/campaign/{id}/automatic-comments-settings","href":"/api-reference/campaigns/update-automatic-comments-settings"},{"title":"Delete Campaign","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json post /client/v2/campaign/{id}/delete","href":"/api-reference/campaigns/delete-campaign"},{"title":"Start Campaign","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json post /client/v2/campaign/{id}/start","href":"/api-reference/campaigns/start-campaign"},{"title":"Stop Campaign","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json post /client/v2/campaign/{id}/stop","href":"/api-reference/campaigns/stop-campaign"},{"title":"Duplicate Campaign","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json post /client/v2/campaign/{id}/duplicate","href":"/api-reference/campaigns/duplicate-campaign"},{"title":"Share Campaign","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json post /client/v2/campaign/{campaignId}/share","href":"/api-reference/campaigns/share-campaign"},{"title":"Transfer Campaign Ownership","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json post /client/v2/campaign/{id}/transfer","href":"/api-reference/campaigns/transfer-campaign-ownership"}]},{"group":"Credits","pages":[{"title":"Get Credit Balance","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json get /client/v2/credits","href":"/api-reference/credits/get-credit-balance"},{"title":"Get Credit Usage","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json get /client/v2/credits/usage","href":"/api-reference/credits/get-credit-usage"},{"title":"Get Credit Balance Activity","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json get /client/v2/credits/balance-activity","href":"/api-reference/credits/get-credit-balance-activity"}]},{"group":"Lead Finder","pages":[{"title":"Get Search Schema","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json get /client/v2/lead-finder/search-schema","href":"/api-reference/lead-finder/get-search-schema"},{"title":"List Industries","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json get /client/v2/lead-finder/industries","href":"/api-reference/lead-finder/list-industries"},{"title":"Search Technologies","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json get /client/v2/lead-finder/technologies","href":"/api-reference/lead-finder/search-technologies"},{"title":"Search Locations","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json get /client/v2/lead-finder/locations","href":"/api-reference/lead-finder/search-locations"},{"title":"Preview People","description":"Runs a people search and returns the first page of the people matched plus `grossTotal`, how many people match in total. There is no further page and no page, size or cursor parameter. Each row carries the person's masked name, role, location, position history and current company, every value verbatim, and never a full name, LinkedIn URL, avatar or contact details. `query` is the flat list of conditions, `{\"filters\":[{\"field\":…,\"op\":…,…}]}`, written in the grammar Get Lead Finder Search Schema publishes for the `version` sent as `schemaVersion`; a query in any other shape is refused before the search, and a condition the grammar does not accept is refused naming it by its path (e.g. `query.filters[3].values`) and, where known, its field and op. Free: consumes no credits. Limit: 100 preview attempts per user, or per API key, in a sliding 24-hour window, regardless of filters or workspace; cached previews and refused attempts count too. Once the limit is reached no search is run and the answer is 429 with `Retry-After`, an approximate wait in seconds, not a guaranteed reset time.","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json post /client/v2/lead-finder/preview","href":"/api-reference/lead-finder/preview-people"},{"title":"Import Prospects","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json post /client/v2/lead-finder/imports","href":"/api-reference/lead-finder/import-prospects"},{"title":"Get Import Outcome","description":"Returns one import: its status, what was asked for and, once the import is terminal, the six numbers that describe what it did. `COMPLETED` means the import ran to the end — it may still have imported nobody, and it was charged for what it retrieved either way. `FAILED` means the import did not complete; `breakdown`, when present, states what was retrieved and charged. `IN_PROGRESS` carries no `breakdown` yet.","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json get /client/v2/lead-finder/imports/{id}","href":"/api-reference/lead-finder/get-import-outcome"}]},{"group":"Voices","pages":[{"title":"List Voices","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json get /client/v2/voices","href":"/api-reference/voices/list-voices"},{"title":"Create Voice","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json post /client/v2/voices","href":"/api-reference/voices/create-voice"},{"title":"Get Voice","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json get /client/v2/voices/{id}","href":"/api-reference/voices/get-voice"},{"title":"Delete Voice","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json delete /client/v2/voices/{id}","href":"/api-reference/voices/delete-voice"},{"title":"Update Voice","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json patch /client/v2/voices/{id}","href":"/api-reference/voices/update-voice"},{"title":"Duplicate Voice","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json post /client/v2/voices/{id}/duplicate","href":"/api-reference/voices/duplicate-voice"}]},{"group":"Direct Messages","pages":[{"title":"List conversations","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json get /client/v2/dm-conversations","href":"/api-reference/direct-messages/list-conversations"},{"title":"List recommended conversations","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json get /client/v2/dm-conversations/recommended","href":"/api-reference/direct-messages/list-recommended-conversations"},{"title":"Get conversation","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json get /client/v2/dm-conversations/{connectionId}","href":"/api-reference/direct-messages/get-conversation"},{"title":"Prepare reply","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json post /client/v2/dm-conversations/{connectionId}/replies","href":"/api-reference/direct-messages/prepare-reply"},{"title":"Generate or improve reply","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json post /client/v2/dm-conversations/{connectionId}/generate-or-improve-reply","href":"/api-reference/direct-messages/generate-or-improve-reply"},{"title":"Snooze conversation","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json post /client/v2/dm-conversations/{connectionId}/snooze","href":"/api-reference/direct-messages/snooze-conversation"},{"title":"Unskip conversation","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json post /client/v2/dm-conversations/{connectionId}/unskip","href":"/api-reference/direct-messages/unskip-conversation"},{"title":"Skip conversation forever","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json post /client/v2/dm-conversations/{connectionId}/skip","href":"/api-reference/direct-messages/skip-conversation-forever"},{"title":"Generate replies","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json post /client/v2/dm-conversations/generate-replies","href":"/api-reference/direct-messages/generate-replies"},{"title":"Edit draft","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json patch /client/v2/dm-replies/{dmId}","href":"/api-reference/direct-messages/edit-draft"},{"title":"Send reply","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json post /client/v2/dm-replies/{dmId}/send","href":"/api-reference/direct-messages/send-reply"},{"title":"Recover draft","deprecated":null,"version":null,"openapi":"https://api.goextrovert.com/client/v2/docs-json post /client/v2/dm-replies/{dmId}/recover","href":"/api-reference/direct-messages/recover-draft"}]}]}]},"basePath":"","title":"Import Prospects - Extrovert API","buildId":"dpl_FWZhTb2vab28gFGFH4ojka6qEznQ","deploymentId":"dpl_FWZhTb2vab28gFGFH4ojka6qEznQ","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CBsVopKK.js","utils-DZAk68jJ.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-D32AYZrP.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-D_A5_cny.js","snippetPresets-xNRfS9th.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BIB25-tq.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CydJ4w4j.js","shallow-CYPBeQSG.js","getApiPlaygroundDisplay-A5xJVBOu.js","CodeSnippet-BVRTgi3m.js","CodeSnippets-DjD6BSlt.js","Page-Dr40SSJq.js","getPastedJson-D4V4JyrR.js","icon-uhcnG22T.js","MethodPill-CM-ZQdGH.js","DuplicateIcon-B_WnOiNf.js","createIcon-CJsb8utt.js","DynamicMarkdown-D-2HDKEp.js","SectionHeading-KP5xmMgQ.js","axios-vUo_bRtp.js","Markdown-D_k0dg6k.js","clsx-DK3K4Z1S.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DE3EVdvd.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-fN9H9n9g.js"]}