Unique identifier for the agent (only returned if the agent 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.3965","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/agents-add","slug":"/api-reference/endpoint/agents-add","pageMetadata":{"title":"Create an Agent","openapi":"POST /agents","description":"Create a new agent","href":"/api-reference/endpoint/agents-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 agent\"\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":"Create an Agent","openapi":"POST /agents","description":"Create a new agent","href":"/api-reference/endpoint/agents-add"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"description":"Create a new agent","requestBody":"e3e788d3-08d8-4d0b-a894-04d4fd7d6906","responses":{"200":"e965bf78-00dc-431e-bd8a-b42744fe1ae4","409":"27d30bf1-b418-4ca8-a1c0-2daf23c53938"},"method":"post","type":"path","servers":["9fc98c87-b07a-4190-a2df-a279790a238b"],"security":["38d8811e-1a7f-42b3-9fc5-d94acb7efb98"],"path":"/agents","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 given to the agent in the MyCald Dashboard","isRequired":true,"uniqueKey":"name","typeLabel":"string"},"instructions":{"type":"string","description":"The instructions for the agent, for example, `Hi, convince the prospect to buy the product`","isRequired":true,"uniqueKey":"instructions","typeLabel":"string"},"maxCallDuration":{"type":"number","description":"The maximum duration of a call in minutes, between 1 and 60","default":10,"uniqueKey":"maxCallDuration","typeLabel":"number"},"recordingSettings":{"type":"object","properties":{"enable":{"type":"boolean","description":"Whether to enable recording of the calls","default":false,"uniqueKey":"recordingSettings.enable","typeLabel":"boolean"}},"uniqueKey":"recordingSettings","typeLabel":"object"},"greeting":{"type":"string","description":"The greeting for the agent, for example, `Hi there!`","uniqueKey":"greeting","typeLabel":"string"},"transferSettings":{"type":"object","properties":{"enable":{"type":"boolean","description":"Whether to enable transfer of the calls","default":false,"uniqueKey":"transferSettings.enable","typeLabel":"boolean"},"rule":{"type":"string","description":"The rule to use for transferring the calls, for example: `transfer the call if the prospect would like to have more information or the AI is unable to answer the question`","default":"always","uniqueKey":"transferSettings.rule","typeLabel":"string"},"phoneNumber":{"type":"string","description":"The phone number to transfer the call to","uniqueKey":"transferSettings.phoneNumber","typeLabel":"string"}},"uniqueKey":"transferSettings","typeLabel":"object"},"machineSettings":{"type":"object","properties":{"enable":{"type":"boolean","description":"Whether to enable machine detection (e.g. IVR, voicemail), where the AI will hang up if it detects a machine","default":false,"uniqueKey":"machineSettings.enable","typeLabel":"boolean"}},"uniqueKey":"machineSettings","typeLabel":"object"},"voicemailSettings":{"type":"object","properties":{"enable":{"type":"boolean","description":"Whether to enable saying a voicemail message if the call is picked up by a voicemail","default":false,"uniqueKey":"voicemailSettings.enable","typeLabel":"boolean"},"voicemail":{"type":"string","description":"The message to say, only available if `enable` is set to `true`, for example, `Hi, this is the AI assistant calling on behalf of John Smith. I was curious if you would be interested in our product. Please call us back at 123-456-7890.`","uniqueKey":"voicemailSettings.voicemail","typeLabel":"string"}},"uniqueKey":"voicemailSettings","typeLabel":"object"},"webhookSettings":{"type":"object","properties":{"enable":{"type":"boolean","description":"Whether to enable sending of a webhook to a URL of your choice when the call is completed","default":false,"uniqueKey":"webhookSettings.enable","typeLabel":"boolean"},"url":{"type":"string","description":"The webhook needs to be an HTTP or HTTPS callback URL. Upon completion of the call, we'll transmit the call ID, transcript, etc. to this URL. This feature is beneficial for receiving real-time notifications at the conclusion of calls.","uniqueKey":"webhookSettings.url","typeLabel":"string"}},"uniqueKey":"webhookSettings","typeLabel":"object"},"smsSettings":{"type":"object","properties":{"enable":{"type":"boolean","description":"Whether to enable sending of text messages","default":false,"uniqueKey":"smsSettings.enable","typeLabel":"boolean"},"rule":{"type":"string","description":"The rule to use for sending text messages, for example: `send a text message if the prospect is interested in the offer`","default":"always","uniqueKey":"smsSettings.rule","typeLabel":"string"},"message":{"type":"string","description":"The message to send, only available if `enable` is set to `true`, for example, `Hi, please visit our website at https://www.example.com` for more information.`","uniqueKey":"smsSettings.message","typeLabel":"string"}},"uniqueKey":"smsSettings","typeLabel":"object"},"voice":{"type":"string","description":"The voice ID of the voice to use for the agent, for example, `standard_male`","default":"standard_male","uniqueKey":"voice","typeLabel":"string"}},"required":["name","instructions"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"name":"\u003cstring>","instructions":"\u003cstring>","maxCallDuration":10,"recordingSettings":{"enable":false},"greeting":"\u003cstring>","transferSettings":{"enable":false,"rule":"always","phoneNumber":"\u003cstring>"},"machineSettings":{"enable":false},"voicemailSettings":{"enable":false,"voicemail":"\u003cstring>"},"webhookSettings":{"enable":false,"url":"\u003cstring>"},"smsSettings":{"enable":false,"rule":"always","message":"\u003cstring>"},"voice":"standard_male"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"e965bf78-00dc-431e-bd8a-b42744fe1ae4":{"description":"Success response with agent details","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","description":"Whether the agent was successfully created, can be either `success` or `failed`","uniqueKey":"status","typeLabel":"string"},"agentId":{"type":"string","description":"Unique identifier for the agent (only returned if the agent was successfully created)","uniqueKey":"agentId","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"status":"\u003cstring>","agentId":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"27d30bf1-b418-4ca8-a1c0-2daf23c53938":{"description":"Agent 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 an Agent - Cald AI","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-01-06T23:53:30.694Z","originalFileLocation":"api-reference/endpoint/agents-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 agent\">\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 an Agent - Cald AI\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create a new agent\">\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/agents-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=Agents\u0026amp;title=Create+an+Agent\u0026amp;description=Create+a+new+agent\u0026amp;theme=2a88449871d4cd4e048f0efa\u0026amp;signature=2a45c1611b03e31863a8a4556ccc931789b89d4a5fbef4335103f3cb35107e13\">\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 an Agent - Cald AI\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create a new agent\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://caldai.mintlify.app/_mintlify/api/og/v2?division=Agents\u0026amp;title=Create+an+Agent\u0026amp;description=Create+a+new+agent\u0026amp;theme=2a88449871d4cd4e048f0efa\u0026amp;signature=2a45c1611b03e31863a8a4556ccc931789b89d4a5fbef4335103f3cb35107e13\">\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/agents-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/agents-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/agents-add#webpage\",\"url\":\"https://docs.cald.ai/api-reference/endpoint/agents-add\",\"name\":\"Create an Agent\",\"description\":\"Create a new agent\",\"dateModified\":\"2026-01-06T23:53:30.694Z\",\"isPartOf\":{\"@id\":\"https://docs.cald.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.cald.ai/api-reference/endpoint/agents-add#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.cald.ai/api-reference/endpoint/agents-add#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Cald AI\",\"item\":\"https://docs.cald.ai\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create an Agent\",\"item\":\"https://docs.cald.ai/api-reference/endpoint/agents-add\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.cald.ai/api-reference/endpoint/agents-add#apireference\",\"headline\":\"Create an Agent\",\"name\":\"Create an Agent\",\"description\":\"Create a new agent\",\"url\":\"https://docs.cald.ai/api-reference/endpoint/agents-add\",\"mainEntityOfPage\":{\"@id\":\"https://docs.cald.ai/api-reference/endpoint/agents-add#webpage\"},\"dateModified\":\"2026-01-06T23:53:30.694Z\",\"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","description":"Get a list of available agents that you can use for the call.","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","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":"Create an Agent - Cald AI","buildId":"dpl_849ArpqvBiCczQiT1Y1stNGpbqHT","deploymentId":"dpl_849ArpqvBiCczQiT1Y1stNGpbqHT","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-Bbp7I60D.js","utils-C3RIvJha.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DqD-vLt8.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-B31Loprg.js","snippetPresets-DKpk-b8t.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-Cj65AhOR.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BXtn5gcC.js","shallow-RY2b03Cp.js","getApiPlaygroundDisplay-B0jeiPk3.js","CodeSnippet-CYgBjjwn.js","CodeSnippets-DOngDrYB.js","Page-n7I5XbKb.js","getPastedJson-DRQbJx-T.js","icon-CQiQCicY.js","MethodPill-BKTLdNtu.js","DuplicateIcon-B9jpAdat.js","createIcon-DCddRrXv.js","DynamicMarkdown-a8hUKrw6.js","SectionHeading-eECVV2eH.js","axios-vUo_bRtp.js","Markdown--GF7ZIpf.js","clsx-DZLdJUrt.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-2LoAhjKH.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-Zwc0ZncM.js"]}