Campaigns are specifically designed to faciliate outbound marketing efforts. They take care of automatically following-up with prospects, and can be used to send emails, text messages, and voicemails. Campaigns also ensure prospects are dialed only during business hours, based on their phone number’s area code.
The schedule enables you to choose the times when your prospects will be called. Cald takes care of automatically determining the time zone based of their phone numbers' area codes, so express the times in your own time zone. The default schedule is to call between 9am and 5pm. Our end time is limited to 8 pm, to avoid calling too late in the evening, and to comply with telephone regulations.
Unique identifier for the campaign (only returned if the campaign was successfully created)
{"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.3966","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":{},"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":"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}],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/endpoint/campaigns-add","slug":"/api-reference/endpoint/campaigns-add","pageMetadata":{"title":"Create a Campaign","openapi":"POST /campaigns","description":"Create a new campaign","href":"/api-reference/endpoint/campaigns-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: \"Create a new campaign\"\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{jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const{Info}={..._provideComponents(),...props.components};if(!Info)_missingMdxReference(`Info`,true);return _jsx(Info,{children:`Campaigns are specifically designed to faciliate outbound marketing efforts. They take care of automatically following-up with prospects, and can be used to send emails, text messages, and voicemails. Campaigns also ensure prospects are dialed only during business hours, based on their phone number’s area code.`})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Create a Campaign","openapi":"POST /campaigns","description":"Create a new campaign","href":"/api-reference/endpoint/campaigns-add"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"description":"Create a new campaign","requestBody":"5b11800c-233c-420c-87b8-060128fc9050","responses":{"200":"6d64e4ba-e2c8-4de7-abba-cefcba014408","404":"0dc77d73-b0b7-455c-8454-497b7612d864","409":"bc77b746-6657-4f79-8f3c-e424b4fc6b4f"},"method":"post","type":"path","servers":["9fc98c87-b07a-4190-a2df-a279790a238b"],"security":["38d8811e-1a7f-42b3-9fc5-d94acb7efb98"],"path":"/campaigns","baseUrlOptions":["https://my.cald.ai/client/api/v1"],"title":"","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"The name of the campaign, it must be unique across all campaigns","isRequired":true,"uniqueKey":"name","typeLabel":"string"},"listId":{"type":"string","description":"The list ID of the list to use for the campaign","isRequired":true,"uniqueKey":"listId","typeLabel":"string"},"agentId":{"type":"string","description":"The agent ID of the agent to use for the campaign","isRequired":true,"uniqueKey":"agentId","typeLabel":"string"},"schedule":{"type":"object","description":"The schedule enables you to choose the times when your prospects will be called. Cald takes care of automatically determining the time zone based of their phone numbers' area codes, so express the times in your own time zone. The default schedule is to call between 9am and 5pm. Our end time is limited to 8 pm, to avoid calling too late in the evening, and to comply with telephone regulations.","properties":{"startHour":{"type":"number","description":"The hour of the day to start the campaign, between 9 and 19","default":9,"uniqueKey":"schedule.startHour","typeLabel":"number"},"startMinute":{"type":"number","description":"The minute of the hour to start the campaign, between 0 and 59","default":0,"uniqueKey":"schedule.startMinute","typeLabel":"number"},"endHour":{"type":"number","description":"The hour of the day to end the campaign, between 9 and 19","default":17,"uniqueKey":"schedule.endHour","typeLabel":"number"},"endMinute":{"type":"number","description":"The minute of the hour to end the campaign, between 0 and 59","default":0,"uniqueKey":"schedule.endMinute","typeLabel":"number"}},"uniqueKey":"schedule","typeLabel":"object"}},"required":["name","listId","agentId"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"name":"\u003cstring>","listId":"\u003cstring>","agentId":"\u003cstring>","schedule":{"startHour":9,"startMinute":0,"endHour":17,"endMinute":0}}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"6d64e4ba-e2c8-4de7-abba-cefcba014408":{"description":"Success response with campaign details","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","description":"Whether the campaign was successfully created, can be either `success` or `failed`","uniqueKey":"status","typeLabel":"string"},"campaignId":{"type":"string","description":"Unique identifier for the campaign (only returned if the campaign was successfully created)","uniqueKey":"campaignId","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"status":"\u003cstring>","campaignId":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"0dc77d73-b0b7-455c-8454-497b7612d864":{"description":"List or agent not found","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"bc77b746-6657-4f79-8f3c-e424b4fc6b4f":{"description":"Campaign with the same name already exists","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":"Create a Campaign - Cald AI","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-01-06T23:53:30.693Z","originalFileLocation":"api-reference/endpoint/campaigns-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=\"Create a new campaign\">\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=\"Create a Campaign - Cald AI\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create a new campaign\">\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/campaigns-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=Campaigns\u0026amp;title=Create+a+Campaign\u0026amp;description=Create+a+new+campaign\u0026amp;theme=2a88449871d4cd4e048f0efa\u0026amp;signature=2ffa89734c438ea9dda4c477407ae1b3f6a206d0064f3a16843731c493f8dc9d\">\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=\"Create a Campaign - Cald AI\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create a new campaign\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://caldai.mintlify.app/_mintlify/api/og/v2?division=Campaigns\u0026amp;title=Create+a+Campaign\u0026amp;description=Create+a+new+campaign\u0026amp;theme=2a88449871d4cd4e048f0efa\u0026amp;signature=2ffa89734c438ea9dda4c477407ae1b3f6a206d0064f3a16843731c493f8dc9d\">\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/campaigns-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/campaigns-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/campaigns-add#webpage\",\"url\":\"https://docs.cald.ai/api-reference/endpoint/campaigns-add\",\"name\":\"Create a Campaign\",\"description\":\"Create a new campaign\",\"dateModified\":\"2026-01-06T23:53:30.693Z\",\"isPartOf\":{\"@id\":\"https://docs.cald.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.cald.ai/api-reference/endpoint/campaigns-add#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.cald.ai/api-reference/endpoint/campaigns-add#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Cald AI\",\"item\":\"https://docs.cald.ai\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create a Campaign\",\"item\":\"https://docs.cald.ai/api-reference/endpoint/campaigns-add\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.cald.ai/api-reference/endpoint/campaigns-add#apireference\",\"headline\":\"Create a Campaign\",\"name\":\"Create a Campaign\",\"description\":\"Create a new campaign\",\"url\":\"https://docs.cald.ai/api-reference/endpoint/campaigns-add\",\"mainEntityOfPage\":{\"@id\":\"https://docs.cald.ai/api-reference/endpoint/campaigns-add#webpage\"},\"dateModified\":\"2026-01-06T23:53:30.693Z\",\"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}","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","description":"Get a list of 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":"Create a Campaign - Cald AI","buildId":"dpl_cadrRc5H9XQiJQbDFN5mcYRs2PAj","deploymentId":"dpl_cadrRc5H9XQiJQbDFN5mcYRs2PAj","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DKJwRUt2.js","utils-CWD_VS3u.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-oFjciODD.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-C76WsxC3.js","snippetPresets-DvPMxpX_.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CuNQfndH.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BVFpVUoF.js","shallow-t59Jg5Kr.js","getApiPlaygroundDisplay-C_JZ4amX.js","CodeSnippet-CLRDnx_h.js","CodeSnippets-C2myU4kc.js","Page-7TwLLapg.js","getPastedJson-B-JaVXw7.js","icon-BA-iDhH3.js","MethodPill-D4qZABFp.js","DuplicateIcon-THIDKO1O.js","createIcon-CYYJwgFd.js","DynamicMarkdown-UGQuxDKp.js","SectionHeading-jYELb23h.js","axios-vUo_bRtp.js","Markdown-DKsLa3wy.js","clsx-CefdjKz2.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BaREnp3o.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-sgx_0XzF.js"]}