Whether the contacts were successfully uploaded, can be either success or failed
{"docsConfig":{"$schema":"https://mintlify.com/docs.json","theme":"mint","name":"Cald AI","colors":{"primary":"#6128c9","light":"#7e66e8","dark":"#100930"},"favicon":"/favicon.jpg","logo":{"light":"https://mintcdn.com/caldai/ds03Lyn4vd_-LMFj/logo/light.svg?fit=max\u0026auto=format\u0026n=ds03Lyn4vd_-LMFj\u0026q=85\u0026s=701689eb8443c639d62306cdffdc4e32","dark":"https://mintcdn.com/caldai/ds03Lyn4vd_-LMFj/logo/dark.svg?fit=max\u0026auto=format\u0026n=ds03Lyn4vd_-LMFj\u0026q=85\u0026s=ef549e63a82e9ec6e72b462244c51741"},"api":{"openapi":["api-reference/openapi.json"]},"navbar":{"links":[{"label":"Support","href":"mailto:support@cald.ai"}],"primary":{"type":"button","label":"MyCald Dashboard","href":"https://my.cald.ai"}},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/cald-ai"}},"navigation":{"global":{"anchors":[{"anchor":"Website","href":"https://cald.ai","icon":"globe"},{"anchor":"Community","href":"https://discord.gg/2sTGFBCsKk","icon":"discord"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"caldai","hasAudioNarration":false,"actualSubdomain":"caldai","customDomains":["docs.cald.ai"],"gitSource":{"type":"github","owner":"francoisvogel","repo":"cald-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a20c40b41886f9eab77bfc8","collectionId":"951a1bc8-e84e-46f4-bfb1-3ab8763a20b7","schemaVersion":"v2"},"entitlements":{},"buildId":"6a20c40b41886f9eab77bfc8:success","clientVersion":"0.0.3971","searchFilterCounts":[{"language":"default","tag":"API Reference","count":27},{"language":"default","tag":"Agents","count":6},{"language":"default","tag":"Campaigns","count":5},{"language":"default","tag":"Lists of Contacts","count":5},{"language":"default","tag":"Phone Number Management (U.S. Only)","count":4},{"language":"default","tag":"Voices","count":3},{"language":"default","tag":"Contacts","count":2},{"language":"default","tag":"Call (Deprecated)","count":1},{"language":"default","tag":"Calls","count":1},{"language":"default","tag":"Documentation","count":1}]},"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":"editor-v7-file-tree","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":"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":"pause-universal-search-reconcile","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":"per-site-search-delta","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":"editor-private-page-search","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":"editor-nav-generations","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":"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":"byok-sep-25","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":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","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":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/endpoint/contacts-add","slug":"/api-reference/endpoint/contacts-add","pageMetadata":{"title":"Upload Contacts to a List","openapi":"POST /lists/{listId}/contacts","description":"Upload contacts to a specific list","href":"/api-reference/endpoint/contacts-add"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Upload contacts to a specific list\"\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":"Upload Contacts to a List","openapi":"POST /lists/{listId}/contacts","description":"Upload contacts to a specific list","href":"/api-reference/endpoint/contacts-add"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"description":"Upload contacts to a specific list","parameters":["41cd3fed-41f3-4b35-a3a8-ef8dae365080"],"requestBody":"fcb720c3-bddf-4a13-94af-9a7d0ba65cc3","responses":{"200":"f15fe885-9048-4a6e-8430-a0fa9322400f","404":"ac0ba242-5938-42d6-9585-a12e13ff24be","409":"be58454d-934f-4e57-9765-18909a4e7e18"},"method":"post","type":"path","servers":["9fc98c87-b07a-4190-a2df-a279790a238b"],"security":["38d8811e-1a7f-42b3-9fc5-d94acb7efb98"],"path":"/lists/{listId}/contacts","baseUrlOptions":["https://my.cald.ai/client/api/v1"],"title":"","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"41cd3fed-41f3-4b35-a3a8-ef8dae365080":{"name":"listId","in":"path","description":"The list ID of the list","required":true,"schema":{"type":"string","isRequired":true,"description":"The list ID of the list","uniqueKey":"","typeLabel":"string"}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"contacts":{"type":"array","description":"List of contacts to upload","items":{"type":"object","properties":{"phoneNumber":{"type":"string","description":"The phone number of the individual or business you're calling. - For international numbers, include the country code without extra formatting (such as parentheses or dashes), for example, '+441234567890'. - For U.S. numbers, although formatting is allowed, it's advisable to remove any additional characters for consistency.","isRequired":true,"uniqueKey":"contacts.items.[INDEX].phoneNumber","typeLabel":"string"},"prospectName":{"type":"string","description":"The prospectName is the default variable that is always present for all agents. It can be used in your agent scripts on the MyCald Dashboard by typing {prospectName}.","uniqueKey":"contacts.items.[INDEX].prospectName","typeLabel":"string"},"email":{"type":"string","description":"The email address of the contact, this is optional","uniqueKey":"contacts.items.[INDEX].email","typeLabel":"string"},"yourCustomVariable":{"type":"string","description":"Feel free to add more custom variables to the list, depending on the use case. Once configured in the agent page of the MyCald Dashboard, they will automatically become available in the API","uniqueKey":"contacts.items.[INDEX].yourCustomVariable","typeLabel":"string"}},"required":["phoneNumber"],"uniqueKey":"contacts.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"contacts","typeLabel":"object[]"}},"required":["contacts"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"contacts":[{"phoneNumber":"\u003cstring>","prospectName":"\u003cstring>","email":"\u003cstring>","yourCustomVariable":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"f15fe885-9048-4a6e-8430-a0fa9322400f":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","description":"Whether the contacts were successfully uploaded, can be either `success` or `failed`","uniqueKey":"status","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"status":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"ac0ba242-5938-42d6-9585-a12e13ff24be":{"description":"List not found","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"be58454d-934f-4e57-9765-18909a4e7e18":{"description":"Contact with the same phone number already exists in the list","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{"38d8811e-1a7f-42b3-9fc5-d94acb7efb98":{"apiKeyAuth":{"type":"apiKey","in":"header","name":"Authorization","description":"Your API key, e.g. `caldLiveDe39a3accb206dd615f30d118e519df0`","scopes":[]}}},"servers":{"9fc98c87-b07a-4190-a2df-a279790a238b":{"url":"https://my.cald.ai/client/api/v1"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"Authorization","description":"Your API key, e.g. `caldLiveDe39a3accb206dd615f30d118e519df0`","scopes":[]},"schema":{"title":"Authorization","type":"string","description":"Your API key, e.g. `caldLiveDe39a3accb206dd615f30d118e519df0`","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"apiKeyAuth","name":"Authorization"}],"title":"apiKeyAuth"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"caldai","siteName":"Cald AI","title":"Upload Contacts to a List - Cald AI","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-01-06T23:53:30.696Z","originalFileLocation":"api-reference/endpoint/contacts-add.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=\"Upload contacts to a specific list\">\u003cmeta data-mint-head name=\"application-name\" content=\"Cald AI\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/caldai/gFpYQ8btuVLkRItW/_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/caldai/gFpYQ8btuVLkRItW/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/caldai/gFpYQ8btuVLkRItW/_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/caldai/gFpYQ8btuVLkRItW/_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/caldai/gFpYQ8btuVLkRItW/_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/caldai/gFpYQ8btuVLkRItW/_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/caldai/gFpYQ8btuVLkRItW/_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/caldai/gFpYQ8btuVLkRItW/_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/caldai/gFpYQ8btuVLkRItW/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Upload Contacts to a List - Cald AI\">\u003cmeta data-mint-head property=\"og:description\" content=\"Upload contacts to a specific list\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Cald AI\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.cald.ai/api-reference/endpoint/contacts-add\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://caldai.mintlify.app/_mintlify/api/og/v2?division=Contacts\u0026amp;title=Upload+Contacts+to+a+List\u0026amp;description=Upload+contacts+to+a+specific+list\u0026amp;theme=2a88449871d4cd4e048f0efa\u0026amp;signature=31e562d3289899d1db2a7f05b2be240ef25861a8f585e0587cc0e98d985ecd5d\">\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=\"Upload Contacts to a List - Cald AI\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Upload contacts to a specific list\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://caldai.mintlify.app/_mintlify/api/og/v2?division=Contacts\u0026amp;title=Upload+Contacts+to+a+List\u0026amp;description=Upload+contacts+to+a+specific+list\u0026amp;theme=2a88449871d4cd4e048f0efa\u0026amp;signature=31e562d3289899d1db2a7f05b2be240ef25861a8f585e0587cc0e98d985ecd5d\">\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/caldai/gFpYQ8btuVLkRItW/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Cald AI\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#6128c9\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.cald.ai/api-reference/endpoint/contacts-add\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/endpoint/contacts-add.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.cald.ai/#organization\",\"name\":\"Cald AI\",\"url\":\"https://docs.cald.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/caldai/ds03Lyn4vd_-LMFj/logo/light.svg?fit=max\u0026auto=format\u0026n=ds03Lyn4vd_-LMFj\u0026q=85\u0026s=701689eb8443c639d62306cdffdc4e32\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.cald.ai#website\",\"name\":\"Cald AI\",\"url\":\"https://docs.cald.ai\",\"publisher\":{\"@id\":\"https://docs.cald.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.cald.ai/api-reference/endpoint/contacts-add#webpage\",\"url\":\"https://docs.cald.ai/api-reference/endpoint/contacts-add\",\"name\":\"Upload Contacts to a List\",\"description\":\"Upload contacts to a specific list\",\"dateModified\":\"2026-01-06T23:53:30.696Z\",\"isPartOf\":{\"@id\":\"https://docs.cald.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.cald.ai/api-reference/endpoint/contacts-add#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.cald.ai/api-reference/endpoint/contacts-add#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Cald AI\",\"item\":\"https://docs.cald.ai\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Upload Contacts to a List\",\"item\":\"https://docs.cald.ai/api-reference/endpoint/contacts-add\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.cald.ai/api-reference/endpoint/contacts-add#apireference\",\"headline\":\"Upload Contacts to a List\",\"name\":\"Upload Contacts to a List\",\"description\":\"Upload contacts to a specific list\",\"url\":\"https://docs.cald.ai/api-reference/endpoint/contacts-add\",\"mainEntityOfPage\":{\"@id\":\"https://docs.cald.ai/api-reference/endpoint/contacts-add#webpage\"},\"dateModified\":\"2026-01-06T23:53:30.696Z\",\"publisher\":{\"@id\":\"https://docs.cald.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.cald.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Cald AI\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Cald AI","nav":{"global":{"anchors":[{"anchor":"Website","href":"https://cald.ai","icon":"globe"},{"anchor":"Community","href":"https://discord.gg/2sTGFBCsKk","icon":"discord"}]},"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/quickstart"}]},{"tab":"API Reference","groups":[{"group":"Agents","pages":[{"title":"Create an Agent","openapi":"POST /agents","href":"/api-reference/endpoint/agents-add"},{"title":"Get Agents","openapi":"GET /agents","href":"/api-reference/endpoint/get-agents"},{"title":"Get an Agent","openapi":"GET /agents/{agentId}","href":"/api-reference/endpoint/get-agent"},{"title":"Edit an Agent","openapi":"PATCH /agents/{agentId}","href":"/api-reference/endpoint/update-agent"},{"title":"Delete an Agent","openapi":"DELETE /agents/{agentId}","href":"/api-reference/endpoint/delete-agent"},{"title":"Make a Call Using an Agent","openapi":"POST /agents/{agentId}/call","href":"/api-reference/endpoint/agents-call"}]},{"group":"Voices","pages":[{"title":"List Voices","openapi":"GET /voices","href":"/api-reference/endpoint/get-voices"},{"title":"Clone a Voice","openapi":"POST /voices/clone","href":"/api-reference/endpoint/clone-voice"},{"title":"Delete a Voice","openapi":"DELETE /voices/{voice}","href":"/api-reference/endpoint/delete-voice"}]},{"group":"Calls","pages":[{"title":"Get Call Logs","openapi":"GET /calls/{callId}","href":"/api-reference/endpoint/get-call"}]},{"group":"Phone Number Management (U.S. Only)","pages":[{"title":"Buy a Phone Number","openapi":"POST /phonenumbers","href":"/api-reference/endpoint/buy-phone-number"},{"title":"Get a list of all phone numbers that you own","openapi":"GET /phonenumbers","href":"/api-reference/endpoint/get-phone-numbers"},{"title":"Edit Phone Number Settings","openapi":"PATCH /phonenumbers/{phoneNumberId}","href":"/api-reference/endpoint/edit-phone-number"},{"title":"Cancel a Phone Number Subscription","openapi":"DELETE /phonenumbers/{phoneNumberId}","href":"/api-reference/endpoint/delete-phone-number"}]},{"group":"Lists of Contacts","pages":[{"title":"Create a List","openapi":"POST /lists","href":"/api-reference/endpoint/lists-add"},{"title":"Get Lists","openapi":"GET /lists","href":"/api-reference/endpoint/get-lists"},{"title":"Get a List","openapi":"GET /lists/{listId}","href":"/api-reference/endpoint/get-list"},{"title":"Edit a List","openapi":"PATCH /lists/{listId}","href":"/api-reference/endpoint/edit-list"},{"title":"Delete a List","openapi":"DELETE /lists/{listId}","description":"Delete a specific list","href":"/api-reference/endpoint/delete-list"}]},{"group":"Contacts","pages":[{"title":"Upload Contacts to a List","openapi":"POST /lists/{listId}/contacts","href":"/api-reference/endpoint/contacts-add"},{"title":"Get Contacts in a List","openapi":"GET /lists/{listId}/contacts","description":"Get a list of contacts in a specific list","href":"/api-reference/endpoint/get-contacts"}]},{"group":"Campaigns","pages":[{"title":"Create a Campaign","openapi":"POST /campaigns","href":"/api-reference/endpoint/campaigns-add"},{"title":"Get Campaigns","openapi":"GET /campaigns","href":"/api-reference/endpoint/get-campaigns"},{"title":"Get a Campaign","openapi":"GET /campaigns/{campaignId}","href":"/api-reference/endpoint/get-campaign"},{"title":"Get Campaign Results","openapi":"GET /campaigns/{campaignId}/details","href":"/api-reference/endpoint/get-campaign-details"},{"title":"Cancel a Campaign","openapi":"PUT /campaigns/{campaignId}/cancel","href":"/api-reference/endpoint/cancel-campaign"}]},{"group":"Call (Deprecated)","pages":[{"title":"Make a Call (Deprecated)","openapi":"POST /call","href":"/api-reference/endpoint/call"}]}]}]},"title":"Upload Contacts to a List - Cald AI","buildId":"dpl_DFJrtvUi8HS5F9nkooKuDJsuD5BM","deploymentId":"dpl_DFJrtvUi8HS5F9nkooKuDJsuD5BM","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-rfhihCWU.js","utils-BmH1XFxk.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-BcNsxPKB.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-BAES3tkd.js","snippetPresets-DCMQBKLP.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-D6l_bzE9.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BOktbnNh.js","shallow-BCs8SgM7.js","getApiPlaygroundDisplay-DEmW5bJB.js","CodeSnippet-CpZOpB9C.js","CodeSnippets-BOBDqibl.js","Page-D5fEM6aW.js","getPastedJson-DH2JBvmr.js","icon-BBJH-kKh.js","MethodPill-D2Sd5NLC.js","DuplicateIcon-CGgfL2qN.js","createIcon-BKudBBzi.js","DynamicMarkdown-85clUA0i.js","SectionHeading-D0JiMgDx.js","axios-vUo_bRtp.js","Markdown-Cfiy0xZO.js","clsx-rL8ZCCw4.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-aeztFa9U.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BywkCr5C.js"]}