If you have large numbers of leads to upload, you can use the bulk upload endpoint.
This endpoint will process the leads in chunks and return the results of the processing.Your CSV file should have the following columns:
phone - Required.
Phone number in E.164 format. Must be US numbers.
If duplicate numbers are found, the row will be skipped.
Example: +18015551831
Org impersonation via x-org-id. Superadmins may impersonate any org; admins may impersonate their direct sub-organizations. Enter the target organization ID to act as that org.
{"docsConfig":{"$schema":"https://mintlify.com/docs.json","theme":"mint","name":"Eqho API","colors":{"primary":"#502fef","light":"#502fef","dark":"#502fef"},"favicon":"https://mintcdn.com/eqho/u4ffk1m_kvB69lIL/docs/favicon.svg?fit=max\u0026auto=format\u0026n=u4ffk1m_kvB69lIL\u0026q=85\u0026s=51f6652439d87b19a38ef415d0c4dd0e","logo":{"light":"https://mintcdn.com/eqho/u4ffk1m_kvB69lIL/docs/logo/light.svg?fit=max\u0026auto=format\u0026n=u4ffk1m_kvB69lIL\u0026q=85\u0026s=b9ce3b45ff5bb64ba3996856006b2ef7","dark":"https://mintcdn.com/eqho/u4ffk1m_kvB69lIL/docs/logo/dark.svg?fit=max\u0026auto=format\u0026n=u4ffk1m_kvB69lIL\u0026q=85\u0026s=bbac44d3af0c7bba78240496b65072e8","href":"https://eqho.ai"},"api":{"examples":{"languages":["bash","python","javascript","go"]},"mdx":{"server":["https://api.eqho.ai"],"auth":{"method":"key","name":"x-api-key"}}},"navbar":{"links":[{"label":"Support","href":"mailto:[email protected]"}],"primary":{"type":"button","label":"Go to app","href":"https://eqho.ai/login"}},"footer":{"socials":{"linkedin":"https://linkedin.com/company/eqho-ai"}},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"eqho","hasAudioNarration":false,"actualSubdomain":"eqho","customDomains":["docs.eqho.ai"],"gitSource":{"type":"github","owner":"echo-ignite","repo":"eqho-api","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"feedback":{"thumbs":true,"issues":true,"edits":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6af615e5701afd0a5b2eff1f","clientVersion":"0.0.4128","searchFilterCounts":[{"language":"default","tag":"API References","count":101},{"language":"default","tag":"Endpoints","count":98},{"language":"default","tag":"Simulations","count":15},{"language":"default","tag":"Knowledge Base","count":10},{"language":"default","tag":"Leads","count":9},{"language":"default","tag":"Agents","count":8},{"language":"default","tag":"Actions","count":7},{"language":"default","tag":"Campaigns","count":5},{"language":"default","tag":"Lead Lists","count":5},{"language":"default","tag":"Reports","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":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"docs/api-reference/leads/bulk-upload","slug":"/docs/api-reference/leads/bulk-upload","pageMetadata":{"title":"Bulk Upload Leads","openapi":"POST /v1/leads/bulk-upload","description":null,"href":"/docs/api-reference/leads/bulk-upload"},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,li:`li`,p:`p`,ul:`ul`,..._provideComponents(),...props.components};return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`If you have large numbers of leads to upload, you can use the bulk upload endpoint.\nThis endpoint will process the leads in chunks and return the results of the processing.`}),`\n`,_jsx(_components.p,{children:`Your CSV file should have the following columns:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`phone`}),` - Required.\nPhone number in E.164 format. Must be US numbers.\nIf duplicate numbers are found, the row will be skipped.\nExample: `,_jsx(_components.code,{children:`+18015551831`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`email`}),` - Required. Email address. Example: `,_jsx(_components.code,{children:`[email protected]`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`first_name`}),` - Required. First name. Example: `,_jsx(_components.code,{children:`Jane`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`last_name`}),` - Required. Last name. Example: `,_jsx(_components.code,{children:`Smith`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`timezone`}),` - Required. Timezone. Example: `,_jsx(_components.code,{children:`US/Mountain`})]}),`\n`]})]})}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":"Bulk Upload Leads","openapi":"POST /v1/leads/bulk-upload","description":null,"href":"/docs/api-reference/leads/bulk-upload"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["leads"],"summary":"Create Leads By Bulk Upload","operationId":"create_leads_by_bulk_upload_v1_leads_bulk_upload_post","requestBody":"3ae62355-ab97-4a88-abe0-47bea52c8e98","responses":{"200":"9703ceeb-0c1d-4846-990c-f01b7eb0a689","400":"87aa980b-154c-4fcf-b6b0-23ead75abe76","422":"5ace1b95-718a-4834-9fe7-cb17f8cbd03b"},"security":["87401b35-c0d6-4d7e-a036-845eb72a8c69","3d83e9d0-4b3a-4f03-a0ef-6484883dd06b"],"method":"post","type":"path","servers":[],"path":"/v1/leads/bulk-upload","baseUrlOptions":["https://api.eqho.ai"],"title":"Create Leads By Bulk Upload","description":"","codeSamples":[],"requestExampleLanguages":["bash","python","javascript","go"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"content":{"multipart/form-data":{"schema":{"properties":{"file":{"type":"string","format":"binary","title":"File","isRequired":true,"uniqueKey":"file","typeLabel":"file"},"lead_list_name":{"oneOf":[{"type":"string","title":"Lead List Name","uniqueKey":"lead_list_name.oneOf.0","typeLabel":"string"},{"type":"null","title":"Lead List Name","uniqueKey":"lead_list_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"lead_list_name","typeLabel":"string | null"},"campaign":{"oneOf":[{"type":"string","title":"Campaign","uniqueKey":"campaign.oneOf.0","typeLabel":"string"},{"type":"null","title":"Campaign","uniqueKey":"campaign.oneOf.1","typeLabel":"null"}],"uniqueKey":"campaign","typeLabel":"string | null"}},"type":"object","required":["file"],"title":"Body_create_leads_by_bulk_upload_v1_leads_bulk_upload_post","uniqueKey":"","typeLabel":"Body_create_leads_by_bulk_upload_v1_leads_bulk_upload_post · object"},"examples":{"Example":{"title":"Example","value":{"file":"\u003cstring>","lead_list_name":"\u003cstring>","campaign":"\u003cstring>"}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"9703ceeb-0c1d-4846-990c-f01b7eb0a689":{"description":"Successful Response","content":{"application/json":{"schema":{"properties":{"summary":{"properties":{"total_records":{"type":"integer","title":"Total Records","isRequired":true,"uniqueKey":"summary.total_records","typeLabel":"integer"},"successful_records":{"type":"integer","title":"Successful Records","isRequired":true,"uniqueKey":"summary.successful_records","typeLabel":"integer"},"error_records":{"type":"integer","title":"Error Records","isRequired":true,"uniqueKey":"summary.error_records","typeLabel":"integer"}},"type":"object","required":["total_records","successful_records","error_records"],"title":"BulkUploadSummary","isRequired":true,"uniqueKey":"summary","typeLabel":"BulkUploadSummary · object"},"errors":{"items":{"properties":{"line_number":{"type":"integer","title":"Line Number","isRequired":true,"uniqueKey":"errors.items.[INDEX].line_number","typeLabel":"integer"},"errors":{"items":{"type":"string","uniqueKey":"errors.items.[INDEX].errors.items.[INDEX]","typeLabel":"string"},"type":"array","title":"Errors","isRequired":true,"uniqueKey":"errors.items.[INDEX].errors","typeLabel":"string[]"}},"type":"object","required":["line_number","errors"],"title":"BulkUploadError","uniqueKey":"errors.items.[INDEX]","typeLabel":"BulkUploadError · object"},"type":"array","title":"Errors","isRequired":true,"uniqueKey":"errors","typeLabel":"BulkUploadError · object[]"}},"type":"object","required":["summary","errors"],"title":"BulkUploadLeadResponse","uniqueKey":"","typeLabel":"BulkUploadLeadResponse · object"},"examples":{"Example":{"title":"Example","value":{"summary":{"total_records":123,"successful_records":123,"error_records":123},"errors":[{"line_number":123,"errors":["\u003cstring>"]}]}}},"exampleType":"generated"}},"exampleType":"generated"},"87aa980b-154c-4fcf-b6b0-23ead75abe76":{"description":"Invalid CSV file or missing required columns","content":{"application/json":{"example":{"detail":"Invalid CSV file or missing required columns"},"examples":{"Example":{"title":"Example","value":{"detail":"Invalid CSV file or missing required columns"}}},"exampleType":"examples"}},"exampleType":"examples"},"5ace1b95-718a-4834-9fe7-cb17f8cbd03b":{"description":"Validation Error","content":{"application/json":{"schema":{"properties":{"detail":{"items":{"properties":{"loc":{"items":{"oneOf":[{"type":"string","uniqueKey":"detail.items.[INDEX].loc.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"integer","uniqueKey":"detail.items.[INDEX].loc.items.[INDEX].oneOf.1","typeLabel":"integer"}],"uniqueKey":"detail.items.[INDEX].loc.items.[INDEX]","typeLabel":"string | integer"},"type":"array","title":"Location","isRequired":true,"uniqueKey":"detail.items.[INDEX].loc","typeLabel":"(string | integer)[]"},"msg":{"type":"string","title":"Message","isRequired":true,"uniqueKey":"detail.items.[INDEX].msg","typeLabel":"string"},"type":{"type":"string","title":"Error Type","isRequired":true,"uniqueKey":"detail.items.[INDEX].type","typeLabel":"string"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError","uniqueKey":"detail.items.[INDEX]","typeLabel":"ValidationError · object"},"type":"array","title":"Detail","uniqueKey":"detail","typeLabel":"ValidationError · object[]"}},"type":"object","title":"HTTPValidationError","uniqueKey":"","typeLabel":"HTTPValidationError · object"},"examples":{"Example":{"title":"Example","value":{"detail":[{"loc":["\u003cstring>"],"msg":"\u003cstring>","type":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"87401b35-c0d6-4d7e-a036-845eb72a8c69":{"APIKeyHeader":{"type":"apiKey","description":"Your API key for authentication.","in":"header","name":"X-API-KEY","scopes":[],"schemeName":"APIKeyHeader"},"OrgImpersonation":{"type":"apiKey","in":"header","name":"x-org-id","description":"Org impersonation via x-org-id. Superadmins may impersonate any org; admins may impersonate their direct sub-organizations. Enter the target organization ID to act as that org.","scopes":[],"schemeName":"OrgImpersonation"}},"3d83e9d0-4b3a-4f03-a0ef-6484883dd06b":{"OAuth2PasswordBearer":{"type":"oauth2","flows":{"password":{"scopes":{},"tokenUrl":"token"}},"scopes":[],"schemeName":"OAuth2PasswordBearer"},"OrgImpersonation":{"type":"apiKey","in":"header","name":"x-org-id","description":"Org impersonation via x-org-id. Superadmins may impersonate any org; admins may impersonate their direct sub-organizations. Enter the target organization ID to act as that org.","scopes":[],"schemeName":"OrgImpersonation"}}},"servers":{},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","description":"Your API key for authentication.","in":"header","name":"X-API-KEY","scopes":[],"schemeName":"APIKeyHeader"},"schema":{"title":"X-API-KEY","type":"string","description":"Your API key for authentication.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"APIKeyHeader","name":"X-API-KEY"},{"scheme":{"type":"apiKey","in":"header","name":"x-org-id","description":"Org impersonation via x-org-id. Superadmins may impersonate any org; admins may impersonate their direct sub-organizations. Enter the target organization ID to act as that org.","scopes":[],"schemeName":"OrgImpersonation"},"schema":{"title":"x-org-id","type":"string","description":"Org impersonation via x-org-id. Superadmins may impersonate any org; admins may impersonate their direct sub-organizations. Enter the target organization ID to act as that org.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"OrgImpersonation","name":"x-org-id"}],"title":"APIKeyHeader \u0026 OrgImpersonation"},{"schemes":[{"scheme":{"type":"oauth2","flows":{"password":{"scopes":{},"tokenUrl":"token"}},"scopes":[],"schemeName":"OAuth2PasswordBearer"},"schema":{"title":"OAuth2 Auth","type":"string","isRequired":true,"description":"The access token received from the authorization server in the OAuth 2.0 flow.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"OAuth2PasswordBearer","name":"Authorization"},{"scheme":{"type":"apiKey","in":"header","name":"x-org-id","description":"Org impersonation via x-org-id. Superadmins may impersonate any org; admins may impersonate their direct sub-organizations. Enter the target organization ID to act as that org.","scopes":[],"schemeName":"OrgImpersonation"},"schema":{"title":"x-org-id","type":"string","description":"Org impersonation via x-org-id. Superadmins may impersonate any org; admins may impersonate their direct sub-organizations. Enter the target organization ID to act as that org.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"OrgImpersonation","name":"x-org-id"}],"title":"OAuth2PasswordBearer \u0026 OrgImpersonation"}]},"originalFileLocation":"docs/api-reference/openapi.json"},"subdomain":"eqho","siteName":"Eqho API","title":"Bulk Upload Leads - Eqho API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-08T21:35:05.381Z","originalFileLocation":"docs/api-reference/leads/bulk-upload.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=\"application-name\" content=\"Eqho 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/eqho/oxggiVRmRK8tBi6H/_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/eqho/oxggiVRmRK8tBi6H/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/eqho/oxggiVRmRK8tBi6H/_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/eqho/oxggiVRmRK8tBi6H/_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/eqho/oxggiVRmRK8tBi6H/_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/eqho/oxggiVRmRK8tBi6H/_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/eqho/oxggiVRmRK8tBi6H/_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/eqho/oxggiVRmRK8tBi6H/_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/eqho/oxggiVRmRK8tBi6H/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Bulk Upload Leads - Eqho API\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Eqho API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.eqho.ai/docs/api-reference/leads/bulk-upload\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://eqho.mintlify.site/_mintlify/api/og/v2?division=Leads\u0026amp;title=Bulk+Upload+Leads\u0026amp;theme=1a82368b06f5136f2cddc31e\u0026amp;signature=9e91cd745cf8df9775baf9863df0fa0c8b73dade5a5c6c3df1e557713d33f05b\">\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=\"Bulk Upload Leads - Eqho API\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://eqho.mintlify.site/_mintlify/api/og/v2?division=Leads\u0026amp;title=Bulk+Upload+Leads\u0026amp;theme=1a82368b06f5136f2cddc31e\u0026amp;signature=9e91cd745cf8df9775baf9863df0fa0c8b73dade5a5c6c3df1e557713d33f05b\">\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/eqho/oxggiVRmRK8tBi6H/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Eqho API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#502fef\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.eqho.ai/docs/api-reference/leads/bulk-upload\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api-reference/leads/bulk-upload.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.eqho.ai/#organization\",\"name\":\"Eqho API\",\"url\":\"https://docs.eqho.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/eqho/u4ffk1m_kvB69lIL/docs/logo/light.svg?fit=max\u0026auto=format\u0026n=u4ffk1m_kvB69lIL\u0026q=85\u0026s=b9ce3b45ff5bb64ba3996856006b2ef7\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.eqho.ai#website\",\"name\":\"Eqho API\",\"url\":\"https://docs.eqho.ai\",\"publisher\":{\"@id\":\"https://docs.eqho.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.eqho.ai/docs/api-reference/leads/bulk-upload#webpage\",\"url\":\"https://docs.eqho.ai/docs/api-reference/leads/bulk-upload\",\"name\":\"Bulk Upload Leads\",\"dateModified\":\"2026-11-08T21:35:05.381Z\",\"isPartOf\":{\"@id\":\"https://docs.eqho.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.eqho.ai/docs/api-reference/leads/bulk-upload#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.eqho.ai/docs/api-reference/leads/bulk-upload#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoints\",\"item\":\"https://docs.eqho.ai/docs/api-reference/actions/get-actions\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Leads\",\"item\":\"https://docs.eqho.ai/docs/api-reference/leads/get-leads\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Bulk Upload Leads\",\"item\":\"https://docs.eqho.ai/docs/api-reference/leads/bulk-upload\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.eqho.ai/docs/api-reference/leads/bulk-upload#apireference\",\"headline\":\"Bulk Upload Leads\",\"name\":\"Bulk Upload Leads\",\"url\":\"https://docs.eqho.ai/docs/api-reference/leads/bulk-upload\",\"mainEntityOfPage\":{\"@id\":\"https://docs.eqho.ai/docs/api-reference/leads/bulk-upload#webpage\"},\"dateModified\":\"2026-11-08T21:35:05.381Z\",\"publisher\":{\"@id\":\"https://docs.eqho.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.eqho.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Eqho API\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Eqho API\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/api-reference/leads/bulk-upload.md","siteName":"Eqho API","nav":{"global":null,"tabs":[{"tab":"API References","groups":[{"group":"API Reference","pages":[{"title":"Eqho API Overview","href":"/docs/api-reference/eqho-api-overview"},{"title":"Creating API Keys","href":"/docs/api-reference/create-api-keys"},{"title":"Authentication","href":"/docs/api-reference/authentication"}]},{"group":"Endpoints","pages":[{"group":"Actions","pages":[{"title":"Get Actions","openapi":"GET /v1/actions","href":"/docs/api-reference/actions/get-actions"},{"title":"Create Action","openapi":"POST /v1/actions","href":"/docs/api-reference/actions/create-action"},{"title":"Get Action By Id","openapi":"GET /v1/actions/{action_id}","href":"/docs/api-reference/actions/get-action"},{"title":"Update Action","openapi":"PUT /v1/actions/{action_id}","href":"/docs/api-reference/actions/update-action"},{"title":"Delete Action","openapi":"DELETE /v1/actions/{action_id}","href":"/docs/api-reference/actions/delete-action"},{"title":"Get Action Types","openapi":"GET /v1/actions/types","href":"/docs/api-reference/actions/get-action-types"},{"title":"Get Global Action Templates","openapi":"GET /v1/actions/templates/global","href":"/docs/api-reference/actions/get-global-templates"}]},{"group":"Agents","pages":[{"title":"Get Agents","openapi":"GET /v1/agents","href":"/docs/api-reference/agents/get-agents"},{"title":"Create Agent","openapi":"POST /v1/agents","href":"/docs/api-reference/agents/create-agent"},{"title":"Get Agent By Id","openapi":"GET /v1/agents/{agent_id}","href":"/docs/api-reference/agents/get-agent"},{"title":"Update Agent","openapi":"PUT /v1/agents/{agent_id}","href":"/docs/api-reference/agents/update-agent"},{"title":"Delete Agent","openapi":"DELETE /v1/agents/{agent_id}","href":"/docs/api-reference/agents/delete-agent"},{"title":"Get Agent Details","openapi":"GET /v1/agents/{agent_id}/details","href":"/docs/api-reference/agents/get-agent-details"},{"title":"Try Agent","openapi":"POST /v1/agents/{agent_id}/try","href":"/docs/api-reference/agents/try-agent"},{"title":"Get Supported Languages","openapi":"GET /v1/agents/languages/all","href":"/docs/api-reference/agents/get-supported-languages"}]},{"group":"Call Now","pages":[{"title":"Call Now","openapi":"POST /v1/call-now/call-lead-now","href":"/docs/api-reference/call-now/call-now"}]},{"group":"Calls","pages":[{"title":"Get Calls","openapi":"GET /v1/calls","href":"/docs/api-reference/calls/get-calls"},{"title":"Get Call By Id","openapi":"GET /v1/calls/{call_id}","href":"/docs/api-reference/calls/get-call"},{"title":"Push External Context Into Call","openapi":"POST /v1/calls/{call_id}/external-context","href":"/docs/api-reference/calls/push-external-context"}]},{"group":"Campaigns","pages":[{"title":"Get Campaigns","openapi":"GET /v1/campaigns","href":"/docs/api-reference/campaigns/get-campaigns"},{"title":"Create Campaign","openapi":"POST /v1/campaigns","href":"/docs/api-reference/campaigns/create-campaign"},{"title":"Get Campaign By Id","openapi":"GET /v1/campaigns/{campaign_id}","href":"/docs/api-reference/campaigns/get-campaign"},{"title":"Update Campaign","openapi":"PUT /v1/campaigns/{campaign_id}","href":"/docs/api-reference/campaigns/update-campaign"},{"title":"Delete Campaign","openapi":"DELETE /v1/campaigns/{campaign_id}","href":"/docs/api-reference/campaigns/delete-campaign"}]},{"group":"Chat","pages":[{"title":"Chat","openapi":"POST /v1/chat","href":"/docs/api-reference/chat/chat"},{"title":"Voice Chat","openapi":"POST /v1/chat/voice","href":"/docs/api-reference/chat/voice"},{"title":"Chat Context","openapi":"POST /v1/chat/context","href":"/docs/api-reference/chat/context"}]},{"group":"Chat Widget","pages":[{"title":"Get Widget Configs","openapi":"GET /v1/chat-widget","href":"/docs/api-reference/chat-widget/index"},{"title":"Create Widget Config","openapi":"POST /v1/chat-widget","href":"/docs/api-reference/chat-widget/create"},{"title":"Get Widget Config By Id","openapi":"GET /v1/chat-widget/{widget_config_id}","href":"/docs/api-reference/chat-widget/show"},{"title":"Delete Widget Config","openapi":"DELETE /v1/chat-widget/{widget_config_id}","href":"/docs/api-reference/chat-widget/delete"}]},{"group":"Knowledge Base","pages":[{"title":"Get Knowledge Bases","openapi":"GET /v1/data-stores","href":"/docs/api-reference/knowledge-bases/get-knowledge-bases"},{"title":"Create Knowledge Base","openapi":"POST /v1/data-stores","href":"/docs/api-reference/knowledge-bases/create-knowledge-base"},{"title":"Get Knowledge Base By Id","openapi":"GET /v1/data-stores/{data_store_id}","href":"/docs/api-reference/knowledge-bases/get-knowledge-base"},{"title":"Update Knowledge Base","openapi":"PUT /v1/data-stores/{data_store_id}","href":"/docs/api-reference/knowledge-bases/update-knowledge-base"},{"title":"Delete Knowledge Base","openapi":"DELETE /v1/data-stores/{data_store_id}","href":"/docs/api-reference/knowledge-bases/delete-knowledge-base"},{"title":"Query Knowledge Base","openapi":"GET /v1/data-stores/search","href":"/docs/api-reference/knowledge-bases/query-knowledge-base"},{"title":"Upload Document","openapi":"POST /v1/data-stores/{data_store_id}/documents","href":"/docs/api-reference/knowledge-bases/upload-document"},{"title":"Delete Document","openapi":"DELETE /v1/data-stores/{data_store_id}/documents","href":"/docs/api-reference/knowledge-bases/delete-document"},{"title":"Upload URL","openapi":"POST /v1/data-stores/{data_store_id}/urls","href":"/docs/api-reference/knowledge-bases/upload-url"},{"title":"Delete URL","openapi":"DELETE /v1/data-stores/{data_store_id}/urls","href":"/docs/api-reference/knowledge-bases/delete-url"}]},{"group":"Lead Lists","pages":[{"title":"Get Lead Lists","openapi":"GET /v1/leads/lists","href":"/docs/api-reference/lead-lists/get-lead-lists"},{"title":"Create Lead List","openapi":"POST /v1/leads/lists","href":"/docs/api-reference/lead-lists/create-lead-list"},{"title":"Get Lead List By Id","openapi":"GET /v1/leads/lists/{list_id}","href":"/docs/api-reference/lead-lists/get-lead-list"},{"title":"Update Lead List","openapi":"PUT /v1/leads/lists/{list_id}","href":"/docs/api-reference/lead-lists/update-lead-list"},{"title":"Delete Lead List","openapi":"DELETE /v1/leads/lists/{list_id}","href":"/docs/api-reference/lead-lists/delete-lead-list"}]},{"group":"Leads","pages":[{"title":"Get Leads","openapi":"GET /v1/leads","href":"/docs/api-reference/leads/get-leads"},{"title":"Create Lead","openapi":"POST /v1/leads","href":"/docs/api-reference/leads/create-lead"},{"title":"Get Lead By Id","openapi":"GET /v1/leads/{lead_id}","href":"/docs/api-reference/leads/get-lead"},{"title":"Update Lead","openapi":"PUT /v1/leads/{lead_id}","href":"/docs/api-reference/leads/update-lead"},{"title":"Delete Lead","openapi":"DELETE /v1/leads/{lead_id}","href":"/docs/api-reference/leads/delete-lead"},{"title":"Search Lead","openapi":"GET /v1/leads/lookup","description":"Searches for a lead using phone number and/or email address within the account of the given API key","href":"/docs/api-reference/leads/lookup-lead"},{"title":"Bulk Upload Leads","openapi":"POST /v1/leads/bulk-upload","href":"/docs/api-reference/leads/bulk-upload"},{"title":"Remove Lead From Lists","openapi":"DELETE /v1/leads/{lead_id}/lists","description":null,"href":"/docs/api-reference/leads/delete-from-lists"},{"title":"Add Phone Numbers To Black List","openapi":"POST /v1/leads/black_list","href":"/docs/api-reference/leads/add-to-blacklist"}]},{"group":"Mentions","pages":[{"title":"Get Mentions","openapi":"GET /v1/mentions","href":"/docs/api-reference/mentions/get-mentions"},{"title":"Get Mention By Id","openapi":"GET /v1/mentions/{mention_id}","href":"/docs/api-reference/mentions/get-mention-by-id"},{"title":"Create Mention","openapi":"POST /v1/mentions","href":"/docs/api-reference/mentions/create-mention"},{"title":"Delete Mention","openapi":"DELETE /v1/mentions/{mention_id}","href":"/docs/api-reference/mentions/delete-mention"}]},{"group":"Phone Numbers","pages":[{"title":"Get Available Phone Numbers","openapi":"GET /v1/phone-numbers/available","href":"/docs/api-reference/phone-numbers/get-available-numbers"},{"title":"Claim Phone Number","openapi":"POST /v1/phone-numbers","href":"/docs/api-reference/phone-numbers/claim-phone-number"},{"title":"Update Phone Number","openapi":"PATCH /v1/phone-numbers","href":"/docs/api-reference/phone-numbers/update-phone-number"},{"title":"Release Phone Number","openapi":"DELETE /v1/phone-numbers","href":"/docs/api-reference/phone-numbers/release-phone-number"}]},{"group":"Reports","pages":[{"title":"Get Disposition Report","openapi":"GET /v2/reports/dispositions","href":"/docs/api-reference/reports/get-dispositions"},{"title":"Get Metrics","openapi":"GET /v2/reports/metrics","href":"/docs/api-reference/reports/get-metrics"},{"title":"Get Reports Table Config","openapi":"GET /v1/reports/table-config","href":"/docs/api-reference/reports/get-table-config"},{"title":"Save Reports Table Config","openapi":"POST /v1/reports/table-config","href":"/docs/api-reference/reports/update-table-config"},{"title":"Get Available Metrics","openapi":"GET /v2/reports/metrics/available","href":"/docs/api-reference/reports/get-available-metrics"},{"title":"High interest metrics","href":"/docs/api-reference/reports/high-interest-metrics"}]},{"group":"Roles","pages":[{"title":"Get Roles","openapi":"GET /v1/roles","href":"/docs/api-reference/roles/get-roles"},{"title":"Create Role","openapi":"POST /v1/roles","href":"/docs/api-reference/roles/create-role"},{"title":"Get Role By Id","openapi":"GET /v1/roles/{role_id}","href":"/docs/api-reference/roles/get-role"},{"title":"Update Role","openapi":"PUT /v1/roles/{role_id}","href":"/docs/api-reference/roles/update-role"},{"title":"Delete Role","openapi":"DELETE /v1/roles/{role_id}","href":"/docs/api-reference/roles/delete-role"}]},{"group":"Scripts","pages":[{"title":"Get Scripts","openapi":"GET /v1/scripts","href":"/docs/api-reference/scripts/get-scripts"},{"title":"Create Script","openapi":"POST /v1/scripts","href":"/docs/api-reference/scripts/create-script"},{"title":"Get Script By Id","openapi":"GET /v1/scripts/{script_id}","href":"/docs/api-reference/scripts/get-script"},{"title":"Update Script","openapi":"PUT /v1/scripts/{script_id}","href":"/docs/api-reference/scripts/update-script"},{"title":"Delete Script","openapi":"DELETE /v1/scripts/{script_id}","href":"/docs/api-reference/scripts/delete-script"}]},{"group":"Simulations","pages":[{"group":"Scenarios","pages":[{"title":"Create Scenario","openapi":"POST /v1/simulation/scenarios","href":"/docs/api-reference/simulations/scenarios/create-scenario"},{"title":"Get Scenario","openapi":"GET /v1/simulation/scenarios/{scenario_id}","href":"/docs/api-reference/simulations/scenarios/get-scenario"},{"title":"Get Scenarios","openapi":"GET /v1/simulation/scenarios","href":"/docs/api-reference/simulations/scenarios/get-scenarios"},{"title":"Update Scenario","openapi":"PUT /v1/simulation/scenarios/{scenario_id}","href":"/docs/api-reference/simulations/scenarios/update-scenario"},{"title":"Delete Scenario","openapi":"DELETE /v1/simulation/scenarios/{scenario_id}","href":"/docs/api-reference/simulations/scenarios/delete-scenario"}]},{"group":"Scenario sets","pages":[{"title":"Create Scenario Set","openapi":"POST /v1/simulation/scenario-sets","href":"/docs/api-reference/simulations/scenario-sets/create-scenario-set"},{"title":"Get Scenario Set","openapi":"GET /v1/simulation/scenario-sets/{scenario_set_id}","href":"/docs/api-reference/simulations/scenario-sets/get-scenario-set"},{"title":"Get Scenario Sets","openapi":"GET /v1/simulation/scenario-sets","href":"/docs/api-reference/simulations/scenario-sets/list-scenario-sets"},{"title":"Update Scenario Set","openapi":"PUT /v1/simulation/scenario-sets/{scenario_set_id}","href":"/docs/api-reference/simulations/scenario-sets/update-scenario-set"},{"title":"Delete Scenario Set","openapi":"DELETE /v1/simulation/scenario-sets/{scenario_set_id}","href":"/docs/api-reference/simulations/scenario-sets/delete-scenario-set"}]},{"title":"Run Simulation","openapi":"POST /v1/simulation","href":"/docs/api-reference/simulations/run-simulation"},{"title":"Get Simulation Result","openapi":"GET /v1/simulation/results/{result_id}","href":"/docs/api-reference/simulations/show-result"},{"title":"Get Simulation Results","openapi":"GET /v1/simulation/results","href":"/docs/api-reference/simulations/get-results"},{"title":"Show Runs for a Simulation Result","openapi":"GET /v1/simulation/results/{result_id}/runs","href":"/docs/api-reference/simulations/list-result-runs"},{"title":"Show Simulation Runs","openapi":"GET /v1/simulation/run/{run_id}","href":"/docs/api-reference/simulations/show-simulation-run"}]},{"group":"Voices","pages":[{"title":"Get Voices","openapi":"GET /v1/voices","href":"/docs/api-reference/voices/get-voices"},{"title":"Update Voice","openapi":"PUT /v1/voices/{voice_id}","href":"/docs/api-reference/voices/update-voice"}]},{"group":"Webhooks","pages":[{"title":"Call Now","openapi":"POST /v1/webhooks/call-now","href":"/docs/api-reference/webhook/call-now"},{"title":"Call Lead Now","openapi":"POST /v1/webhooks/call-lead-now","href":"/docs/api-reference/webhook/call-lead-now"},{"title":"Create Lead and Call","openapi":"POST /v1/webhooks/create-and-call","href":"/docs/api-reference/webhook/create-and-call"}]}]}]}]},"basePath":"","title":"Bulk Upload Leads - Eqho API","buildId":"dpl_5tKr6cUUeuVJdEZ9JAEY3h4soMJ8","deploymentId":"dpl_5tKr6cUUeuVJdEZ9JAEY3h4soMJ8","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DbeN8Wo6.js","utils-CwSb5Doc.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-BmREeM3N.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-AYjWerCj.js","snippetPresets-QD4ULQlp.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-Digj5cjF.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CiHrzluR.js","shallow-D7h7pFGg.js","getApiPlaygroundDisplay-mlxkpAUf.js","CodeSnippet-D2rH5lZI.js","CodeSnippets-B53ulOaL.js","Page-CqcDm2To.js","getPastedJson-DxGeNMih.js","icon-BHbyrebp.js","MethodPill-C7F_KEEJ.js","DuplicateIcon-j3c5-73z.js","createIcon-OvCnyFqD.js","DynamicMarkdown-DpAS3GCb.js","SectionHeading-DMPpdrvW.js","axios-vUo_bRtp.js","Markdown-D7pDRguu.js","clsx-2_c6mSt_.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-Cu7_SikL.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-ydqCcy4b.js"]}