API key used for authenticating requests to the API.
string
required
Workspace identifier for the API.
Request Body
string
required
The phone number to which the call will be made.
string
required
The ID of the agent assigned to make the call.
string
A URL to receive webhook events about the call. If provided, this URL will be used for notifications.
object
Dynamic variables that can be used to customize call scripts. Each key represents a variable that can be inserted into the call script dynamically. For example:
Show Dynamic Variables Details
string
First name of the person to address in the call.
string
Last name of the person.
string
Zip code for regional customization or information.
string
Full address for detailed directions or service customization.
string
Email address to reference or verify during the call.
object
Any fields passed here will be sent to the call agent and directly passed to the webhook triggered by the agent under its ‘metadata’ header, but they will not be included in the call agent’s context.
Show Metadata Details
Response Fields
string
The status of the request, indicating the success or failure of the call initiation.
string
A unique identifier assigned to the initiated call. This ID can be used to track the call’s progress or retrieve its details later.
string
A message providing feedback about the call initiation process, typically confirming successful initiation or describing an error.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Trillet AI","colors":{"primary":"#0062E9","light":"#27A3FD","dark":"#0062E9"},"logo":{"light":"https://mintcdn.com/trilletai/EdcrcTJCQ9witVNd/logo/Trillet-logo-light.png?fit=max\u0026auto=format\u0026n=EdcrcTJCQ9witVNd\u0026q=85\u0026s=07a28a94606d5b153efce99ab90540fe","dark":"https://mintcdn.com/trilletai/4w-maff9zXfYJwwQ/logo/Trillet-logo-dark.svg?fit=max\u0026auto=format\u0026n=4w-maff9zXfYJwwQ\u0026q=85\u0026s=f229f955d63c6b1d05383924f2215385","href":"https://docs.trillet.ai/"},"favicon":"https://mintcdn.com/trilletai/4w-maff9zXfYJwwQ/favicon.svg?fit=max\u0026auto=format\u0026n=4w-maff9zXfYJwwQ\u0026q=85\u0026s=ce49c1133a36856421c21ace5d2665f5","api":{"mdx":{"auth":{"method":"key","name":"x-api-key"},"server":"https://api.trillet.ai"}},"appearance":{"default":"light","strict":false},"background":{"decoration":"windows","color":{"light":"#f5f8ff","dark":"#000718"}},"navbar":{"links":[{"href":"https://discord.com/invite/4qbWtkbT93","label":"Join Community"}],"primary":{"type":"button","label":"Get Started!","href":"https://app.trillet.ai"}},"footer":{"socials":{"discord":"https://discord.com/invite/4qbWtkbT93","github":"https://github.com/TrilletAI","linkedin":"https://linkedin.com/company/trillet-ai"}},"search":{"prompt":"Expedite Development - Search Trillet..."},"seo":{"indexing":"all"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"trilletai","hasAudioNarration":false,"actualSubdomain":"trilletai","customDomains":[],"gitSource":{"type":"github","owner":"verlat-pty-ltd","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6abeb7683ee38fd3dde389cd","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"API Reference V1","count":76},{"language":"default","tag":"Documentation","count":8},{"language":"default","tag":"Conversations","count":8},{"language":"default","tag":"Batch Calls","count":7},{"language":"default","tag":"Calls","count":7},{"language":"default","tag":"Folder Management","count":7},{"language":"default","tag":"Knowledge Base","count":7},{"language":"default","tag":"Getting Started","count":6},{"language":"default","tag":"Message Flows","count":6},{"language":"default","tag":"Workspaces","count":6}]},"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":"site-roles","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":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"v1/api-reference/endpoints/calls/initiate-call","slug":"/v1/api-reference/endpoints/calls/initiate-call","pageMetadata":{"title":"Initiate Outbound Call","api":"POST /v1/api/call","description":"Send an AI-driven phone call to a given number.","href":"/v1/api-reference/endpoints/calls/initiate-call","hidden":false},"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: \"Send an AI-driven phone call to a given number.\"\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,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={p:`p`,..._provideComponents(),...props.components},{Expandable,Heading,ParamField,ResponseField}=_components;if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`3`,id:`headers`,children:`Headers`}),`\n`,_jsx(ParamField,{header:`x-api-key`,type:`string`,required:true,id:`param-x-api-key`,children:_jsx(_components.p,{children:`API key used for authenticating requests to the API.`})}),`\n`,_jsx(ParamField,{header:`x-workspace-id`,type:`string`,required:true,id:`param-x-workspace-id`,children:_jsx(_components.p,{children:`Workspace identifier for the API.`})}),`\n`,_jsx(Heading,{level:`3`,id:`request-body`,children:`Request Body`}),`\n`,_jsx(ParamField,{body:`to`,type:`string`,required:true,id:`param-to`,children:_jsx(_components.p,{children:`The phone number to which the call will be made.`})}),`\n`,_jsx(ParamField,{body:`call_agent_id`,type:`string`,required:true,id:`param-call-agent-id`,children:_jsx(_components.p,{children:`The ID of the agent assigned to make the call.`})}),`\n`,_jsx(ParamField,{body:`callback_url`,type:`string`,optional:true,id:`param-callback-url`,children:_jsx(_components.p,{children:`A URL to receive webhook events about the call. If provided, this URL will be used for notifications.`})}),`\n`,_jsxs(ParamField,{body:`dynamic_variables`,type:`object`,id:`param-dynamic-variables`,children:[_jsx(_components.p,{children:`Dynamic variables that can be used to customize call scripts. Each key represents a variable that can be inserted into the call script dynamically. For example:`}),_jsxs(Expandable,{title:`Dynamic Variables Details`,children:[_jsx(ParamField,{body:`firstName`,type:`string`,id:`param-first-name`,children:_jsx(_components.p,{children:`First name of the person to address in the call.`})}),_jsx(ParamField,{body:`lastName`,type:`string`,id:`param-last-name`,children:_jsx(_components.p,{children:`Last name of the person.`})}),_jsx(ParamField,{body:`Zipcode`,type:`string`,id:`param-zipcode`,children:_jsx(_components.p,{children:`Zip code for regional customization or information.`})}),_jsx(ParamField,{body:`address`,type:`string`,id:`param-address`,children:_jsx(_components.p,{children:`Full address for detailed directions or service customization.`})}),_jsx(ParamField,{body:`email`,type:`string`,id:`param-email`,children:_jsx(_components.p,{children:`Email address to reference or verify during the call.`})})]})]}),`\n`,_jsxs(ParamField,{body:`metadata`,type:`object`,optional:true,id:`param-metadata`,children:[_jsx(_components.p,{children:`Any fields passed here will be sent to the call agent and directly passed to the webhook triggered by the agent under its ‘metadata’ header, but they will not be included in the call agent’s context.`}),_jsx(Expandable,{title:`Metadata Details`})]}),`\n`,_jsx(Heading,{level:`3`,id:`response-fields`,children:`Response Fields`}),`\n`,_jsx(ResponseField,{name:`status`,type:`string`,id:`param-status`,children:_jsx(_components.p,{children:`The status of the request, indicating the success or failure of the call initiation.`})}),`\n`,_jsx(ResponseField,{name:`call_id`,type:`string`,id:`param-call-id`,children:_jsx(_components.p,{children:`A unique identifier assigned to the initiated call. This ID can be used to track the call’s progress or retrieve its details later.`})}),`\n`,_jsx(ResponseField,{name:`message`,type:`string`,id:`param-message`,children:_jsx(_components.p,{children:`A message providing feedback about the call initiation process, typically confirming successful initiation or describing an error.`})})]})}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":"Initiate Outbound Call","api":"POST /v1/api/call","description":"Send an AI-driven phone call to a given number.","href":"/v1/api-reference/endpoints/calls/initiate-call","hidden":false}}},"mdxSourceWithNoJs":null,"noJsSplices":[[181,187,"code:`code`,p:`p`,pre:`pre`,span:`span`,"],[233,294,"CodeBlock,Expandable,Heading,ParamField,ResponseExample,ResponseField}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!"],[461,476,"Example)_missingMdxReference(`ResponseExample`,true);if(!ResponseField)_missingM"],[3929,3941,",`\n`,_jsx(ResponseExample,{children:_jsx(CodeBlock,{filename:``,numberOfLines:`5`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`5`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"success\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"call_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"123456789\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Call initiated successfully\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})})]})}function"]]},"mdxExtracts":{"tableOfContents":[{"title":"Headers","slug":"headers","depth":3,"children":[]},{"title":"Request Body","slug":"request-body","depth":3,"children":[]},{"title":"Response Fields","slug":"response-fields","depth":3,"children":[]}],"codeExamples":{"response":{"type":"ResponseExample","children":[{"filename":"","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"5\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"status\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"success\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"call_id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"123456789\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"message\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Call initiated successfully\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]}},"endpoint":{"title":"Initiate Outbound Call","path":"/v1/api/call","servers":[{"url":"https://api.trillet.ai"}],"method":"post","request":{"security":[{"title":"API Key Auth","parameters":{"header":{"x-api-key":{"type":"apiKey"}},"query":{},"cookie":{}}}],"parameters":{"query":{},"header":{"x-api-key":{"schema":[{"type":"string","description":"API key used for authenticating requests to the API.","required":true}]},"x-workspace-id":{"schema":[{"type":"string","description":"Workspace identifier for the API.","required":true}]}},"cookie":{},"path":{}},"body":{"application/json":{"schemaArray":[{"type":"object","properties":{"to":[{"type":"string","description":"The phone number to which the call will be made.","required":true}],"call_agent_id":[{"type":"string","description":"The ID of the agent assigned to make the call.","required":true}],"callback_url":[{"type":"string","description":"A URL to receive webhook events about the call. If provided, this URL will be used for notifications."}],"dynamic_variables":[{"type":"object","properties":{"firstName":[{"type":"string","description":"First name of the person to address in the call."}],"lastName":[{"type":"string","description":"Last name of the person."}],"Zipcode":[{"type":"string","description":"Zip code for regional customization or information."}],"address":[{"type":"string","description":"Full address for detailed directions or service customization."}],"email":[{"type":"string","description":"Email address to reference or verify during the call."}]},"description":"Dynamic variables that can be used to customize call scripts. Each key represents a variable that can be inserted into the call script dynamically. For example:"}],"metadata":[{"type":"object","properties":{},"description":"Any fields passed here will be sent to the call agent and directly passed to the webhook triggered by the agent under its ‘metadata’ header, but they will not be included in the call agent’s context."}]}}],"examples":{"example":{"value":{"to":"\u003cstring>","call_agent_id":"\u003cstring>","callback_url":"\u003cstring>","dynamic_variables":{"firstName":"\u003cstring>","lastName":"\u003cstring>","Zipcode":"\u003cstring>","address":"\u003cstring>","email":"\u003cstring>"},"metadata":{}}}}}}},"response":{"200":{"application/json":{"schemaArray":[{"type":"object","properties":{"status":[{"type":"string","description":"The status of the request, indicating the success or failure of the call initiation."}],"call_id":[{"type":"string","description":"A unique identifier assigned to the initiated call. This ID can be used to track the call’s progress or retrieve its details later."}],"message":[{"type":"string","description":"A message providing feedback about the call initiation process, typically confirming successful initiation or describing an error."}]}}],"examples":{"example":{"value":{"status":"\u003cstring>","call_id":"\u003cstring>","message":"\u003cstring>"}}}}}},"deprecated":false}},"jsLinks":[],"subdomain":"trilletai","siteName":"Trillet AI","title":"Initiate Outbound Call - Trillet AI","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2025-12-22T07:30:37.739Z","originalFileLocation":"v1/api-reference/endpoints/calls/initiate-call.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=\"light\"}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=\"Send an AI-driven phone call to a given number.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Trillet 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/trilletai/WsSLZfz49PHxmYgQ/_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/trilletai/WsSLZfz49PHxmYgQ/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/trilletai/WsSLZfz49PHxmYgQ/_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/trilletai/WsSLZfz49PHxmYgQ/_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/trilletai/WsSLZfz49PHxmYgQ/_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/trilletai/WsSLZfz49PHxmYgQ/_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/trilletai/WsSLZfz49PHxmYgQ/_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/trilletai/WsSLZfz49PHxmYgQ/_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/trilletai/WsSLZfz49PHxmYgQ/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Initiate Outbound Call - Trillet AI\">\u003cmeta data-mint-head property=\"og:description\" content=\"Send an AI-driven phone call to a given number.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Trillet AI\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://trilletai.mintlify.app/v1/api-reference/endpoints/calls/initiate-call\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://trilletai.mintlify.site/_mintlify/api/og/v2?division=Calls\u0026amp;title=Initiate+Outbound+Call\u0026amp;description=Send+an+AI-driven+phone+call+to+a+given+number.\u0026amp;theme=ad4cc57a896f08cb575728ab\u0026amp;signature=7ba659b802778394aaed3e5170c71cba2b2cf31d2a846fc3093c31be221ba120\">\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=\"Initiate Outbound Call - Trillet AI\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Send an AI-driven phone call to a given number.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://trilletai.mintlify.site/_mintlify/api/og/v2?division=Calls\u0026amp;title=Initiate+Outbound+Call\u0026amp;description=Send+an+AI-driven+phone+call+to+a+given+number.\u0026amp;theme=ad4cc57a896f08cb575728ab\u0026amp;signature=7ba659b802778394aaed3e5170c71cba2b2cf31d2a846fc3093c31be221ba120\">\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/trilletai/WsSLZfz49PHxmYgQ/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Trillet AI\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0062E9\">\u003clink data-mint-head rel=\"canonical\" href=\"https://trilletai.mintlify.app/v1/api-reference/endpoints/calls/initiate-call\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/v1/api-reference/endpoints/calls/initiate-call.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://trilletai.mintlify.app/#organization\",\"name\":\"Trillet AI\",\"url\":\"https://trilletai.mintlify.app\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/trilletai/EdcrcTJCQ9witVNd/logo/Trillet-logo-light.png?fit=max\u0026auto=format\u0026n=EdcrcTJCQ9witVNd\u0026q=85\u0026s=07a28a94606d5b153efce99ab90540fe\"}},{\"@type\":\"WebSite\",\"@id\":\"https://trilletai.mintlify.app#website\",\"name\":\"Trillet AI\",\"url\":\"https://trilletai.mintlify.app\",\"publisher\":{\"@id\":\"https://trilletai.mintlify.app/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://trilletai.mintlify.app/v1/api-reference/endpoints/calls/initiate-call#webpage\",\"url\":\"https://trilletai.mintlify.app/v1/api-reference/endpoints/calls/initiate-call\",\"name\":\"Initiate Outbound Call\",\"description\":\"Send an AI-driven phone call to a given number.\",\"dateModified\":\"2025-12-22T07:30:37.739Z\",\"isPartOf\":{\"@id\":\"https://trilletai.mintlify.app#website\"},\"breadcrumb\":{\"@id\":\"https://trilletai.mintlify.app/v1/api-reference/endpoints/calls/initiate-call#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://trilletai.mintlify.app/v1/api-reference/endpoints/calls/initiate-call#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Trillet AI\",\"item\":\"https://trilletai.mintlify.app\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Initiate Outbound Call\",\"item\":\"https://trilletai.mintlify.app/v1/api-reference/endpoints/calls/initiate-call\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://trilletai.mintlify.app/v1/api-reference/endpoints/calls/initiate-call#apireference\",\"headline\":\"Initiate Outbound Call\",\"name\":\"Initiate Outbound Call\",\"description\":\"Send an AI-driven phone call to a given number.\",\"url\":\"https://trilletai.mintlify.app/v1/api-reference/endpoints/calls/initiate-call\",\"mainEntityOfPage\":{\"@id\":\"https://trilletai.mintlify.app/v1/api-reference/endpoints/calls/initiate-call#webpage\"},\"dateModified\":\"2025-12-22T07:30:37.739Z\",\"publisher\":{\"@id\":\"https://trilletai.mintlify.app/#organization\"},\"isPartOf\":{\"@id\":\"https://trilletai.mintlify.app#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Trillet AI\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Trillet AI\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/v1/api-reference/endpoints/calls/initiate-call.md","siteName":"Trillet AI","nav":{"global":null,"tabs":[{"tab":"Documentation","icon":"book-open","pages":[{"title":"Documentation","href":"/documentation/introduction"}]},{"tab":"Change Log","icon":"clock","pages":[{"title":"Change Log","href":"/changelog/changelog"}]},{"tab":"API Reference V1","icon":"square-terminal","groups":[{"group":"API Reference V1","icon":"square-terminal","pages":[{"title":"API Reference","href":"/v1/api-reference/introduction"},{"title":"Authentication","href":"/v1/api-reference/authentication"}]},{"group":"Workspaces","icon":"briefcase","pages":[{"title":"Create Workspace","api":"POST /v1/api/workspaces","href":"/v1/api-reference/endpoints/workspace/create-workspace"},{"title":"Invite Team Member","api":"POST /v1/api/workspaces/{workspaceId}/invite","href":"/v1/api-reference/endpoints/workspace/invite-team-member"},{"title":"Get Workspace by ID","api":"GET /v1/api/workspaces/{workspaceId}","href":"/v1/api-reference/endpoints/workspace/get-workspace-by-id"},{"title":"Get Pending Invitations","api":"GET /v1/api/workspaces/invitations/pending","href":"/v1/api-reference/endpoints/workspace/get-pending-invitation"},{"title":"Update Workspace Name","api":"PUT /v1/api/workspaces/{workspaceId}","href":"/v1/api-reference/endpoints/workspace/update-name"},{"title":"Delete Workspace","api":"DELETE /v1/api/workspaces/{workspaceId}","description":"Delete an existing workspace. Only the owner of the workspace can delete it. Master workspaces and the user's only remaining workspace cannot be deleted.","href":"/v1/api-reference/endpoints/workspace/delete-workspace"}]},{"group":"Calls","icon":"phone-volume","pages":[{"title":"Initiate Outbound Call","api":"POST /v1/api/call","href":"/v1/api-reference/endpoints/calls/initiate-call"},{"title":"Export Call History CSV","api":"POST /v2/api/call-history/export-csv","description":"Export call history records as a CSV file with optional transcript and post-analysis data.","href":"/v1/api-reference/endpoints/calls/call-history/export"},{"title":"List Call Histories","api":"GET /v2/api/call-history","href":"/v1/api-reference/endpoints/calls/call-history/list"},{"title":"Get a Specific Call History","api":"GET /v2/api/call-history/{callHistoryId}","href":"/v1/api-reference/endpoints/calls/call-history/get"},{"title":"Get Phone Numbers","api":"GET /v1/api/twilio/user-phone-numbers","href":"/v1/api-reference/endpoints/calls/call-history/get-phoneNumber"},{"title":"Get Call History Metrics","api":"GET /v2/api/call-history/metrics","href":"/v1/api-reference/endpoints/calls/call-history/metrics"},{"title":"Get Call Recording","api":"GET /v1/api/calls/recordings/{callSid}","href":"/v1/api-reference/endpoints/calls/get-recording"}]},{"group":"Batch Calls","icon":"phone-intercom","pages":[{"title":"Batch Calls Overview","href":"/v1/api-reference/endpoints/calls/batch/overview"},{"title":"Start Batch Calls","api":"POST /v1/api/batch-calls","href":"/v1/api-reference/endpoints/calls/batch/start"},{"title":"List Batch Calls","api":"GET /v1/api/batch-calls/{batchId}/calls","href":"/v1/api-reference/endpoints/calls/batch/list-calls"},{"title":"Get Batch Status","api":"GET /v1/api/batch-calls/{batchId}","href":"/v1/api-reference/endpoints/calls/batch/get-status"},{"title":"Get Batch Progress","api":"GET /v1/api/batch-calls/{batchId}/status","href":"/v1/api-reference/endpoints/calls/batch/get-progress"},{"title":"Get Individual Call Status","api":"GET /v1/api/batch-calls/{batchId}/calls/{jobId}","href":"/v1/api-reference/endpoints/calls/batch/get-call-status"},{"title":"Cancel Batch Operation","api":"DELETE /v1/api/batch-calls/{batchId}","href":"/v1/api-reference/endpoints/calls/batch/cancel"}]},{"group":"Telephony","icon":"phone-office","pages":[{"title":"Bring Your Own Number","api":"POST /v1/api/twilio/register-external-number","href":"/v1/api-reference/endpoints/telephony/register-externalNumber"},{"title":"Assign Phone Number to Agent","api":"POST /v1/api/agents/{agentId}/bind/{phoneNumberId}","href":"/v1/api-reference/endpoints/telephony/bind-call-to-phoneNumber"},{"title":"Unassign Phone Number from Agent","api":"POST /v1/api/agents/{agentId}/release/{phoneNumberId}","href":"/v1/api-reference/endpoints/telephony/unbind-call-to-phoneNumber"},{"title":"Release Phone Number","api":"POST /v1/api/twilio/release-number","href":"/v1/api-reference/endpoints/phone-numbers/release"},{"title":"List Phone Numbers","api":"GET /v1/api/twilio/user-phone-numbers","href":"/v1/api-reference/endpoints/phone-numbers/list"}]},{"group":"Conversations","icon":"comments","pages":[{"title":"Generate Message","api":"POST /v1/api/conversations/message/generate","href":"/v1/api-reference/endpoints/conversations/generateMessage"},{"title":"Handle Message Action","api":"POST /v1/api/conversations/{conversationId}/message/{messageId}/action","href":"/v1/api-reference/endpoints/conversations/messageAction"},{"title":"Edit Customer Details","api":"POST /v1/api/conversations/{conversationId}/customer/edit","href":"/v1/api-reference/endpoints/conversations/editCustomerDetails"},{"title":"Get All Conversations","api":"GET /v1/api/conversations","href":"/v1/api-reference/endpoints/conversations/getAll"},{"title":"Get Conversations By Flow ID","api":"GET /v1/api/conversations/flow/{flowId}","href":"/v1/api-reference/endpoints/conversations/getConvosByFlow"},{"title":"Get Conversation By ID","api":"GET /v1/api/conversations/{conversationId}","href":"/v1/api-reference/endpoints/conversations/getById"},{"title":"Delete Message","api":"DELETE /v1/api/conversations/{conversationId}/message/{messageId}","href":"/v1/api-reference/endpoints/conversations/deleteMessage"},{"title":"Delete Conversation","api":"DELETE /v1/api/conversations/{conversationId}","href":"/v1/api-reference/endpoints/conversations/deleteConvo"}]},{"group":"Folder Management","icon":"folder","pages":[{"title":"Create Flow Folder","api":"POST /v1/api/flow-folders","href":"/v1/api-reference/endpoints/folder/create-folder"},{"title":"Add Flow to Folder","api":"POST /v1/api/flow-folders/{folderId}/flows","href":"/v1/api-reference/endpoints/folder/add-flow-to-folder"},{"title":"Get All Folders for Workspace","api":"GET /v1/api/flow-folders","href":"/v1/api-reference/endpoints/folder/get-all-folders"},{"title":"Get Folder Details with Flows","api":"GET /v1/api/flow-folders/{folderId}","href":"/v1/api-reference/endpoints/folder/get-folder-details"},{"title":"Update Folder","api":"PATCH /v1/api/flow-folders/{folderId}","href":"/v1/api-reference/endpoints/folder/update-folder"},{"title":"Remove Flow from Folder","api":"DELETE /v1/api/flow-folders/{folderId}/flows/{pathwayId}","href":"/v1/api-reference/endpoints/folder/remove-flow-from-folder"},{"title":"Delete Folder","api":"DELETE /v1/api/flow-folders/{folderId}","href":"/v1/api-reference/endpoints/folder/delete-folder"}]},{"group":"Call Flows","icon":"diagram-next","pages":[{"title":"Create Call Flow","api":"POST /v1/api/call-flows","href":"/v1/api-reference/endpoints/flows/call-flows/create"},{"title":"List Call Flows","api":"GET /v1/api/call-flows","href":"/v1/api-reference/endpoints/flows/call-flows/list"},{"title":"Get Call Flow","api":"GET /v1/api/call-flows/{id}","href":"/v1/api-reference/endpoints/flows/call-flows/get"},{"title":"Update Call Flow","api":"PUT /v1/api/call-flows/{id}","href":"/v1/api-reference/endpoints/flows/call-flows/update"},{"title":"Delete Call Flow","api":"DELETE /v1/api/call-flows/{id}","href":"/v1/api-reference/endpoints/flows/call-flows/delete"}]},{"group":"Message Flows","icon":"diagram-project","pages":[{"title":"Create Message Flow","api":"POST /v1/api/message-flows","href":"/v1/api-reference/endpoints/flows/message-flows/create"},{"title":"List Message Flows","api":"GET /v1/api/message-flows","href":"/v1/api-reference/endpoints/flows/message-flows/list"},{"title":"Get Message Flow","api":"GET /v1/api/message-flows/{id}","href":"/v1/api-reference/endpoints/flows/message-flows/get"},{"title":"Update Message Flow","api":"PUT /v1/api/message-flows/{id}","href":"/v1/api-reference/endpoints/flows/message-flows/update"},{"title":"Toggle Autopilot","api":"PUT /v1/api/message-flows/{id}/toggle-autopilot","href":"/v1/api-reference/endpoints/flows/message-flows/toggle-autopilot"},{"title":"Delete Message Flow","api":"DELETE /v1/api/message-flows/{id}","href":"/v1/api-reference/endpoints/flows/message-flows/delete"}]},{"group":"Call Agents","icon":"user-check","pages":[{"title":"Create Call Agent","api":"POST /v1/api/agents","href":"/v1/api-reference/endpoints/agents/call/create"},{"title":"List Call Agents","api":"GET /v1/api/agents","href":"/v1/api-reference/endpoints/agents/call/list"},{"title":"Get Call Agent","api":"GET /v1/api/agents/{agentId}","href":"/v1/api-reference/endpoints/agents/call/get"},{"title":"Update Call Agent","api":"PUT /v1/api/agents/{agentId}","href":"/v1/api-reference/endpoints/agents/call/update"},{"title":"Delete Call Agent","api":"DELETE /v1/api/agents/{agentId}","href":"/v1/api-reference/endpoints/agents/call/delete"}]},{"group":"Omni Flow Agents (Message)","icon":"users","pages":[{"title":"Create Omni Flow Agent","api":"POST /v1/api/omni-flow-agents","href":"/v1/api-reference/endpoints/agents/omniflow/create"},{"title":"List Omni Flow Agents","api":"GET /v1/api/omni-flow-agents","href":"/v1/api-reference/endpoints/agents/omniflow/list"},{"title":"Get Omni Flow Agent","api":"GET /v1/api/omni-flow-agents/{id}","href":"/v1/api-reference/endpoints/agents/omniflow/get"},{"title":"Update Omni Flow Agent","api":"PUT /v1/api/omni-flow-agents/{agentId}","href":"/v1/api-reference/endpoints/agents/omniflow/update"},{"title":"Delete Omni Flow Agent","api":"DELETE /v1/api/omni-flow-agents/{agentId}","href":"/v1/api-reference/endpoints/agents/omniflow/delete"}]},{"group":"Knowledge Base","icon":"book","pages":[{"title":"Create Knowledge Base","api":"POST /v1/api/knowledgebase","href":"/v1/api-reference/endpoints/knowledge-base/create"},{"title":"Upload File to Knowledge Base","api":"POST /v1/api/knowledgebase/{id}/files","href":"/v1/api-reference/endpoints/knowledge-base/upload-file"},{"title":"Add Text to Knowledge Base","api":"POST /v1/api/knowledgebase/{id}/text","href":"/v1/api-reference/endpoints/knowledge-base/add-text"},{"title":"List Knowledge Bases","api":"GET /v1/api/knowledgebase","href":"/v1/api-reference/endpoints/knowledge-base/list"},{"title":"Get Knowledge Base","api":"GET /v1/api/knowledgebase/{id}","href":"/v1/api-reference/endpoints/knowledge-base/get"},{"title":"Update Knowledge Base","api":"PUT /v1/api/knowledgebase/{id}","href":"/v1/api-reference/endpoints/knowledge-base/update"},{"title":"Delete Knowledge Base","api":"DELETE /v1/api/knowledgebase/{id}","href":"/v1/api-reference/endpoints/knowledge-base/delete"}]},{"group":"Active Calls","icon":"phone-flip","pages":[{"title":"List Active Calls","api":"GET /v2/api/active-calls","href":"/v1/api-reference/endpoints/active-calls/list"},{"title":"Get Active Call Details","api":"GET /v2/api/active-calls/{roomName}","href":"/v1/api-reference/endpoints/active-calls/get"},{"title":"Get Call Insights","api":"GET /v2/api/active-calls/{roomName}/insights","href":"/v1/api-reference/endpoints/active-calls/get-insights"}]},{"group":"Recordings","icon":"circle-dot","pages":[{"title":"Get Recording","api":"GET /v2/api/recordings/{callHistoryId}","href":"/v1/api-reference/endpoints/recordings/get"}]}]}]},"basePath":"","title":"Initiate Outbound Call - Trillet AI","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["c2aa737661","2b790eda92","b0f84f53ff"],"chunks":["OpenApiReferenceProvider-CiUHMMOm.js","snippetPresets-BgfXU7Bw.js","utils-DWvOwgy_.js","style-to-object-BY3JEAdk.js","utils-BN7RXSMJ.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-CFw8bq89.js","conditional-requirements-CFM0id0Q.js","cloneDeep-CAwdfOU2.js","_Uint8Array-BJr8e-ZL.js","isObject-FP1Yky1u.js","ApiExamples-XX0UgMZK.js","usePlaygroundInputsStore-DXDFSa1V.js","shallow-CdX5aREi.js","isEqual-CoOaxexF.js","CodeSnippets-Cg2wpzWm.js","CodeSnippet-D_HwgQO_.js","getApiPlaygroundDisplay-CmCoerhe.js","Page-CVJ-f_k1.js","DynamicMarkdown-CQM9Bhbv.js","SectionHeading-DpbrP8nQ.js","icon-BPCgijHy.js","MethodPill-GQ8DuY0c.js","getPastedJson-Cb5mT31m.js","Check2Icon-a7bUI6e8.js","axios-CsQoIw0U.js"]}