Caller ID / originating phone number in E.164 format. Must be a number assigned to this agent. If omitted, the system picks from the agent's assigned outbound numbers automatically.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Truedy API Documentation","colors":{"primary":"#6366F1","light":"#818CF8","dark":"#4F46E5"},"logo":{"light":"https://mintcdn.com/truedy/WTUBrv0A4HPRDyoq/logo/truedy-light.png?fit=max\u0026auto=format\u0026n=WTUBrv0A4HPRDyoq\u0026q=85\u0026s=1523538b1cea9fc7da3b8863aa6278e3","dark":"https://mintcdn.com/truedy/WTUBrv0A4HPRDyoq/logo/truedy-dark.png?fit=max\u0026auto=format\u0026n=WTUBrv0A4HPRDyoq\u0026q=85\u0026s=8988ad55e36f4ac0ff4230b3013390b7"},"favicon":"https://mintcdn.com/truedy/yjkqd-aWUBOPgmva/favicon-32x32.png?fit=max\u0026auto=format\u0026n=yjkqd-aWUBOPgmva\u0026q=85\u0026s=f034db1610e7afb4db811cb7e26b4a86","navbar":{"links":[{"href":"mailto:support@truedy.ai","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.truedy.ai"}},"footer":{"socials":{"x":"https://twitter.com/truedy","github":"https://github.com/truedy","linkedin":"https://www.linkedin.com/company/truedy"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Documentation","icon":"book-open-cover","href":"https://docs.truedy.ai"},{"anchor":"API Reference","icon":"code","href":"https://docs.truedy.ai/api-reference"},{"anchor":"Support","icon":"headset","href":"mailto:support@truedy.ai"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"truedy","hasAudioNarration":false,"actualSubdomain":"truedy","customDomains":["docs.truedy.ai"],"gitSource":{"type":"github","owner":"aarohx10","repo":"documentation","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a99747e4f577282a9ad5c4b","collectionId":"c6a614ae-a87c-409a-8640-8ff8b050dc52","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6a99747e4f577282a9ad5c4b"},"entitlements":{},"buildId":"6a99747e4f577282a9ad5c4b","clientVersion":"0.0.4043","searchFilterCounts":[{"language":"default","tag":"API Reference","count":102},{"language":"default","tag":"Endpoints","count":92},{"language":"default","tag":"Guides","count":40},{"language":"default","tag":"Calls","count":15},{"language":"default","tag":"Batch Calls","count":12},{"language":"default","tag":"Contacts","count":12},{"language":"default","tag":"Knowledge Spaces","count":12},{"language":"default","tag":"Telephony","count":11},{"language":"default","tag":"API documentation","count":10},{"language":"default","tag":"Webhooks","count":9}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/calls/create-call","slug":"/api-reference/calls/create-call","pageMetadata":{"title":"Create Call","description":"Create an outbound call. Direction is always outbound; organization is set from API key.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /calls","href":"/api-reference/calls/create-call","autogeneratedByOpenApi":true},"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 an outbound call. Direction is always outbound; organization is set from API key.\"\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 Call","description":"Create an outbound call. Direction is always outbound; organization is set from API key.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /calls","href":"/api-reference/calls/create-call","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Calls"],"summary":"Create Call","description":"Create an outbound call. Direction is always outbound; organization is set from API key.","operationId":"create_call_api_public_v1_calls_post","parameters":["2eb988c2-7587-410f-bc4e-756c9a068b26","0d3ec342-9e0f-49c4-868f-5500e300205a"],"requestBody":"ebf7eb97-33f0-4014-8210-3192fed91244","responses":{"201":"26ef2e49-01ff-4463-8305-061df943d821","401":"0ed06260-80e3-4303-b2fc-e32540c61a31","403":"b56917a7-398d-41dc-81a3-19b38a8daa33","422":"9f47e827-ce0c-4e4b-bff5-2ba6ac66bd03","429":"0a796553-18c5-4ced-ac6f-e4d7bd0d6890","500":"96fa1763-619c-4375-bfab-e71d62e41669"},"security":["7d8bc2fe-bc9e-4992-b96d-a39b94ed3816"],"method":"post","type":"path","servers":["57f5b051-6b39-4322-bc5e-d5cee6a37201"],"path":"/calls","baseUrlOptions":["https://api.truedy.ai/api/public/v1"],"title":"Create Call","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"2eb988c2-7587-410f-bc4e-756c9a068b26":{"name":"X-Idempotency-Key","in":"header","required":false,"schema":{"oneOf":[{"type":"string","title":"X-Idempotency-Key","uniqueKey":"oneOf.0","typeLabel":"string"},{"type":"null","title":"X-Idempotency-Key","uniqueKey":"oneOf.1","typeLabel":"null"}],"isRequired":false,"uniqueKey":"","typeLabel":"string | null"}},"0d3ec342-9e0f-49c4-868f-5500e300205a":{"name":"X-Truedy-Workspace-Id","in":"header","required":false,"schema":{"oneOf":[{"type":"string","title":"X-Truedy-Workspace-Id","description":"Target workspace ID for account-scoped master API keys.","uniqueKey":"oneOf.0","typeLabel":"string"},{"type":"null","title":"X-Truedy-Workspace-Id","description":"Target workspace ID for account-scoped master API keys.","uniqueKey":"oneOf.1","typeLabel":"null"}],"isRequired":false,"uniqueKey":"","typeLabel":"string | null"},"description":"Target workspace ID for account-scoped master API keys."}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"agent_id":{"type":"string","title":"Agent Id","description":"Agent ID to use for the call","example":"agt_123e4567-e89b-12d3-a456-426614174000","isRequired":true,"uniqueKey":"agent_id","typeLabel":"string"},"phone_number":{"type":"string","pattern":"^\\+[1-9]\\d{1,14}$","title":"Phone Number","description":"Destination phone number in E.164 format (the number to call)","example":"+15551234567","isRequired":true,"uniqueKey":"phone_number","typeLabel":"string"},"from_number":{"oneOf":[{"type":"string","title":"From Number","description":"Caller ID / originating phone number in E.164 format. Must be a number assigned to this agent. If omitted, the system picks from the agent's assigned outbound numbers automatically.","pattern":"^\\+[1-9]\\d{1,14}$","example":"+15559876543","uniqueKey":"from_number.oneOf.0","typeLabel":"string"},{"type":"null","title":"From Number","description":"Caller ID / originating phone number in E.164 format. Must be a number assigned to this agent. If omitted, the system picks from the agent's assigned outbound numbers automatically.","example":"+15559876543","uniqueKey":"from_number.oneOf.1","typeLabel":"null"}],"uniqueKey":"from_number","typeLabel":"string | null"},"call_settings":{"oneOf":[{"type":"object","title":"PublicCallSettings","description":"Optional per-call settings (recording, greeting, timeouts)","properties":{"recording_enabled":{"oneOf":[{"type":"boolean","title":"Recording Enabled","description":"Whether to record the call","default":true,"uniqueKey":"call_settings.oneOf.0.recording_enabled.oneOf.0","typeLabel":"boolean"},{"type":"null","title":"Recording Enabled","description":"Whether to record the call","default":true,"uniqueKey":"call_settings.oneOf.0.recording_enabled.oneOf.1","typeLabel":"null"}],"uniqueKey":"call_settings.oneOf.0.recording_enabled","typeLabel":"boolean | null"},"transcription_enabled":{"oneOf":[{"type":"boolean","title":"Transcription Enabled","description":"Whether to transcribe the call","default":true,"uniqueKey":"call_settings.oneOf.0.transcription_enabled.oneOf.0","typeLabel":"boolean"},{"type":"null","title":"Transcription Enabled","description":"Whether to transcribe the call","default":true,"uniqueKey":"call_settings.oneOf.0.transcription_enabled.oneOf.1","typeLabel":"null"}],"uniqueKey":"call_settings.oneOf.0.transcription_enabled","typeLabel":"boolean | null"},"greeting":{"oneOf":[{"type":"string","title":"Greeting","description":"Override greeting text for this call","uniqueKey":"call_settings.oneOf.0.greeting.oneOf.0","typeLabel":"string"},{"type":"null","title":"Greeting","description":"Override greeting text for this call","uniqueKey":"call_settings.oneOf.0.greeting.oneOf.1","typeLabel":"null"}],"uniqueKey":"call_settings.oneOf.0.greeting","typeLabel":"string | null"},"max_duration":{"oneOf":[{"type":"string","title":"Max Duration","description":"Max call duration (e.g. 3600s). Overrides agent default for this call.","uniqueKey":"call_settings.oneOf.0.max_duration.oneOf.0","typeLabel":"string"},{"type":"null","title":"Max Duration","description":"Max call duration (e.g. 3600s). Overrides agent default for this call.","uniqueKey":"call_settings.oneOf.0.max_duration.oneOf.1","typeLabel":"null"}],"uniqueKey":"call_settings.oneOf.0.max_duration","typeLabel":"string | null"},"join_timeout":{"oneOf":[{"type":"string","title":"Join Timeout","description":"Timeout for callee to answer (e.g. 30s). Overrides agent default for this call.","uniqueKey":"call_settings.oneOf.0.join_timeout.oneOf.0","typeLabel":"string"},{"type":"null","title":"Join Timeout","description":"Timeout for callee to answer (e.g. 30s). Overrides agent default for this call.","uniqueKey":"call_settings.oneOf.0.join_timeout.oneOf.1","typeLabel":"null"}],"uniqueKey":"call_settings.oneOf.0.join_timeout","typeLabel":"string | null"}},"uniqueKey":"call_settings.oneOf.0","typeLabel":"PublicCallSettings · object"},{"type":"null","description":"Optional per-call settings (recording, greeting, timeouts)","uniqueKey":"call_settings.oneOf.1","typeLabel":"null"}],"uniqueKey":"call_settings","typeLabel":"PublicCallSettings · object | null"},"variables":{"oneOf":[{"type":"object","title":"Variables","description":"Key-value pairs for mustache template substitution in agent prompts (e.g. first_name, company)","additionalProperties":true,"uniqueKey":"variables.oneOf.0","typeLabel":"Variables · object"},{"type":"null","title":"Variables","description":"Key-value pairs for mustache template substitution in agent prompts (e.g. first_name, company)","uniqueKey":"variables.oneOf.1","typeLabel":"null"}],"uniqueKey":"variables","typeLabel":"Variables · object | null"}},"type":"object","required":["agent_id","phone_number"],"title":"PublicCallCreate","description":"Create an outbound call via the Public API. Organization is set from API key; direction is always outbound.","uniqueKey":"","typeLabel":"PublicCallCreate · object"},"examples":{"Example":{"title":"Example","value":{"agent_id":"agt_123e4567-e89b-12d3-a456-426614174000","phone_number":"+15551234567","from_number":"+15559876543","call_settings":{"recording_enabled":true,"transcription_enabled":true,"greeting":"\u003cstring>","max_duration":"\u003cstring>","join_timeout":"\u003cstring>"},"variables":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"26ef2e49-01ff-4463-8305-061df943d821":{"description":"Successful Response","content":{"application/json":{"schema":{"properties":{"data":{"properties":{"id":{"type":"string","title":"Id","description":"Unique call identifier","isRequired":true,"uniqueKey":"data.id","typeLabel":"string"},"status":{"type":"string","title":"Status","description":"Call status: queued, ringing, in_progress, completed, failed","isRequired":true,"uniqueKey":"data.status","typeLabel":"string"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"When the call was created","isRequired":true,"uniqueKey":"data.created_at","typeLabel":"string\u003cdate-time>"},"agent_id":{"oneOf":[{"type":"string","title":"Agent Id","description":"ID of the agent used for this call","uniqueKey":"data.agent_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Agent Id","description":"ID of the agent used for this call","uniqueKey":"data.agent_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.agent_id","typeLabel":"string | null"},"phone_number":{"oneOf":[{"type":"string","title":"Phone Number","description":"Destination or source phone number (E.164)","uniqueKey":"data.phone_number.oneOf.0","typeLabel":"string"},{"type":"null","title":"Phone Number","description":"Destination or source phone number (E.164)","uniqueKey":"data.phone_number.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.phone_number","typeLabel":"string | null"},"from_number":{"oneOf":[{"type":"string","title":"From Number","description":"Originating phone number","uniqueKey":"data.from_number.oneOf.0","typeLabel":"string"},{"type":"null","title":"From Number","description":"Originating phone number","uniqueKey":"data.from_number.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.from_number","typeLabel":"string | null"},"to_number":{"oneOf":[{"type":"string","title":"To Number","description":"Destination phone number","uniqueKey":"data.to_number.oneOf.0","typeLabel":"string"},{"type":"null","title":"To Number","description":"Destination phone number","uniqueKey":"data.to_number.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.to_number","typeLabel":"string | null"},"direction":{"oneOf":[{"type":"string","title":"Direction","description":"Call direction: inbound, outbound","uniqueKey":"data.direction.oneOf.0","typeLabel":"string"},{"type":"null","title":"Direction","description":"Call direction: inbound, outbound","uniqueKey":"data.direction.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.direction","typeLabel":"string | null"},"started_at":{"oneOf":[{"type":"string","title":"Started At","description":"When the call started","format":"date-time","uniqueKey":"data.started_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","title":"Started At","description":"When the call started","uniqueKey":"data.started_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.started_at","typeLabel":"string\u003cdate-time> | null"},"ended_at":{"oneOf":[{"type":"string","title":"Ended At","description":"When the call ended","format":"date-time","uniqueKey":"data.ended_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","title":"Ended At","description":"When the call ended","uniqueKey":"data.ended_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.ended_at","typeLabel":"string\u003cdate-time> | null"},"duration_seconds":{"oneOf":[{"type":"integer","title":"Duration Seconds","description":"Call duration in seconds","uniqueKey":"data.duration_seconds.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Duration Seconds","description":"Call duration in seconds","uniqueKey":"data.duration_seconds.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.duration_seconds","typeLabel":"integer | null"},"summary":{"oneOf":[{"type":"string","title":"Summary","description":"AI-generated call summary","uniqueKey":"data.summary.oneOf.0","typeLabel":"string"},{"type":"null","title":"Summary","description":"AI-generated call summary","uniqueKey":"data.summary.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.summary","typeLabel":"string | null"},"short_summary":{"oneOf":[{"type":"string","title":"Short Summary","description":"Short summary if available","uniqueKey":"data.short_summary.oneOf.0","typeLabel":"string"},{"type":"null","title":"Short Summary","description":"Short summary if available","uniqueKey":"data.short_summary.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.short_summary","typeLabel":"string | null"},"recording_url":{"oneOf":[{"type":"string","title":"Recording Url","description":"URL to the call recording if recording was enabled","uniqueKey":"data.recording_url.oneOf.0","typeLabel":"string"},{"type":"null","title":"Recording Url","description":"URL to the call recording if recording was enabled","uniqueKey":"data.recording_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.recording_url","typeLabel":"string | null"},"updated_at":{"oneOf":[{"type":"string","title":"Updated At","description":"When the call was last updated","format":"date-time","uniqueKey":"data.updated_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","title":"Updated At","description":"When the call was last updated","uniqueKey":"data.updated_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.updated_at","typeLabel":"string\u003cdate-time> | null"},"context":{"oneOf":[{"type":"object","title":"Context","description":"Custom context or variables passed for the call","additionalProperties":true,"uniqueKey":"data.context.oneOf.0","typeLabel":"Context · object"},{"type":"null","title":"Context","description":"Custom context or variables passed for the call","uniqueKey":"data.context.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.context","typeLabel":"Context · object | null"},"transcript":{"oneOf":[{"title":"Transcript","description":"Call transcript messages as returned by the voice provider","uniqueKey":"data.transcript.oneOf.0","typeLabel":"any"},{"type":"null","title":"Transcript","description":"Call transcript messages as returned by the voice provider","uniqueKey":"data.transcript.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.transcript","typeLabel":"any | null"}},"type":"object","required":["id","status","created_at"],"title":"PublicCallResponse","description":"Call object","isRequired":true,"uniqueKey":"data","typeLabel":"PublicCallResponse · object"},"meta":{"properties":{"request_id":{"type":"string","title":"Request Id","description":"Unique request identifier for support and debugging","isRequired":true,"uniqueKey":"meta.request_id","typeLabel":"string"},"ts":{"type":"string","format":"date-time","title":"Ts","description":"Server timestamp when the response was generated","isRequired":true,"uniqueKey":"meta.ts","typeLabel":"string\u003cdate-time>"}},"type":"object","required":["request_id","ts"],"title":"ResponseMeta","description":"Request metadata","isRequired":true,"uniqueKey":"meta","typeLabel":"ResponseMeta · object"}},"type":"object","required":["data","meta"],"title":"PublicCallSingleResponse","uniqueKey":"","typeLabel":"PublicCallSingleResponse · object"},"examples":{"Example":{"title":"Example","value":{"data":{"id":"\u003cstring>","status":"\u003cstring>","created_at":"2023-11-07T05:31:56Z","agent_id":"\u003cstring>","phone_number":"\u003cstring>","from_number":"\u003cstring>","to_number":"\u003cstring>","direction":"\u003cstring>","started_at":"2023-11-07T05:31:56Z","ended_at":"2023-11-07T05:31:56Z","duration_seconds":123,"summary":"\u003cstring>","short_summary":"\u003cstring>","recording_url":"\u003cstring>","updated_at":"2023-11-07T05:31:56Z","context":{},"transcript":"\u003cunknown>"},"meta":{"request_id":"\u003cstring>","ts":"2023-11-07T05:31:56Z"}}}},"exampleType":"generated"}},"exampleType":"generated"},"0ed06260-80e3-4303-b2fc-e32540c61a31":{"description":"Missing, malformed, expired, inactive, or invalid API key.","content":{"application/json":{"schema":{"type":"object","required":["error","meta"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Stable machine-readable error code.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable explanation.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"oneOf":[{"description":"Structured, endpoint-specific details. Never rely on undocumented provider fields.","type":"object","uniqueKey":"error.details.oneOf.0","typeLabel":"object"},{"description":"Structured, endpoint-specific details. Never rely on undocumented provider fields.","type":"array","uniqueKey":"error.details.oneOf.1","typeLabel":"array"},{"description":"Structured, endpoint-specific details. Never rely on undocumented provider fields.","type":"null","uniqueKey":"error.details.oneOf.2","typeLabel":"null"}],"uniqueKey":"error.details","typeLabel":"object | array | null"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"meta":{"properties":{"request_id":{"type":"string","title":"Request Id","description":"Unique request identifier for support and debugging","isRequired":true,"uniqueKey":"meta.request_id","typeLabel":"string"},"ts":{"type":"string","format":"date-time","title":"Ts","description":"Server timestamp when the response was generated","isRequired":true,"uniqueKey":"meta.ts","typeLabel":"string\u003cdate-time>"}},"type":"object","required":["request_id","ts"],"title":"ResponseMeta","description":"Request correlation metadata.","isRequired":true,"uniqueKey":"meta","typeLabel":"ResponseMeta · object"}},"example":{"error":{"code":"validation_error","message":"Missing required field: name","details":{"errors":[]}},"meta":{"request_id":"req_01JEXAMPLE","ts":"2026-08-21T00:00:00Z"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"validation_error","message":"Missing required field: name","details":{"errors":[]}},"meta":{"request_id":"req_01JEXAMPLE","ts":"2026-08-21T00:00:00Z"}}}},"exampleType":"generated"}},"exampleType":"generated"},"b56917a7-398d-41dc-81a3-19b38a8daa33":{"description":"The API key is valid but the request is not permitted by its organization, IP allowlist, or scope.","content":{"application/json":{"schema":{"type":"object","required":["error","meta"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Stable machine-readable error code.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable explanation.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"oneOf":[{"description":"Structured, endpoint-specific details. Never rely on undocumented provider fields.","type":"object","uniqueKey":"error.details.oneOf.0","typeLabel":"object"},{"description":"Structured, endpoint-specific details. Never rely on undocumented provider fields.","type":"array","uniqueKey":"error.details.oneOf.1","typeLabel":"array"},{"description":"Structured, endpoint-specific details. Never rely on undocumented provider fields.","type":"null","uniqueKey":"error.details.oneOf.2","typeLabel":"null"}],"uniqueKey":"error.details","typeLabel":"object | array | null"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"meta":{"properties":{"request_id":{"type":"string","title":"Request Id","description":"Unique request identifier for support and debugging","isRequired":true,"uniqueKey":"meta.request_id","typeLabel":"string"},"ts":{"type":"string","format":"date-time","title":"Ts","description":"Server timestamp when the response was generated","isRequired":true,"uniqueKey":"meta.ts","typeLabel":"string\u003cdate-time>"}},"type":"object","required":["request_id","ts"],"title":"ResponseMeta","description":"Request correlation metadata.","isRequired":true,"uniqueKey":"meta","typeLabel":"ResponseMeta · object"}},"example":{"error":{"code":"validation_error","message":"Missing required field: name","details":{"errors":[]}},"meta":{"request_id":"req_01JEXAMPLE","ts":"2026-08-21T00:00:00Z"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"validation_error","message":"Missing required field: name","details":{"errors":[]}},"meta":{"request_id":"req_01JEXAMPLE","ts":"2026-08-21T00:00:00Z"}}}},"exampleType":"generated"}},"exampleType":"generated"},"9f47e827-ce0c-4e4b-bff5-2ba6ac66bd03":{"description":"The request is syntactically valid but fails endpoint validation.","content":{"application/json":{"schema":{"type":"object","required":["error","meta"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Stable machine-readable error code.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable explanation.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"oneOf":[{"description":"Structured, endpoint-specific details. Never rely on undocumented provider fields.","type":"object","uniqueKey":"error.details.oneOf.0","typeLabel":"object"},{"description":"Structured, endpoint-specific details. Never rely on undocumented provider fields.","type":"array","uniqueKey":"error.details.oneOf.1","typeLabel":"array"},{"description":"Structured, endpoint-specific details. Never rely on undocumented provider fields.","type":"null","uniqueKey":"error.details.oneOf.2","typeLabel":"null"}],"uniqueKey":"error.details","typeLabel":"object | array | null"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"meta":{"properties":{"request_id":{"type":"string","title":"Request Id","description":"Unique request identifier for support and debugging","isRequired":true,"uniqueKey":"meta.request_id","typeLabel":"string"},"ts":{"type":"string","format":"date-time","title":"Ts","description":"Server timestamp when the response was generated","isRequired":true,"uniqueKey":"meta.ts","typeLabel":"string\u003cdate-time>"}},"type":"object","required":["request_id","ts"],"title":"ResponseMeta","description":"Request correlation metadata.","isRequired":true,"uniqueKey":"meta","typeLabel":"ResponseMeta · object"}},"example":{"error":{"code":"validation_error","message":"Missing required field: name","details":{"errors":[]}},"meta":{"request_id":"req_01JEXAMPLE","ts":"2026-08-21T00:00:00Z"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"validation_error","message":"Missing required field: name","details":{"errors":[]}},"meta":{"request_id":"req_01JEXAMPLE","ts":"2026-08-21T00:00:00Z"}}}},"exampleType":"generated"}},"exampleType":"generated"},"0a796553-18c5-4ced-ac6f-e4d7bd0d6890":{"description":"The API key or organization exceeded a configured request limit. Retry after the response headers/window indicate.","content":{"application/json":{"schema":{"type":"object","required":["error","meta"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Stable machine-readable error code.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable explanation.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"oneOf":[{"description":"Structured, endpoint-specific details. Never rely on undocumented provider fields.","type":"object","uniqueKey":"error.details.oneOf.0","typeLabel":"object"},{"description":"Structured, endpoint-specific details. Never rely on undocumented provider fields.","type":"array","uniqueKey":"error.details.oneOf.1","typeLabel":"array"},{"description":"Structured, endpoint-specific details. Never rely on undocumented provider fields.","type":"null","uniqueKey":"error.details.oneOf.2","typeLabel":"null"}],"uniqueKey":"error.details","typeLabel":"object | array | null"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"meta":{"properties":{"request_id":{"type":"string","title":"Request Id","description":"Unique request identifier for support and debugging","isRequired":true,"uniqueKey":"meta.request_id","typeLabel":"string"},"ts":{"type":"string","format":"date-time","title":"Ts","description":"Server timestamp when the response was generated","isRequired":true,"uniqueKey":"meta.ts","typeLabel":"string\u003cdate-time>"}},"type":"object","required":["request_id","ts"],"title":"ResponseMeta","description":"Request correlation metadata.","isRequired":true,"uniqueKey":"meta","typeLabel":"ResponseMeta · object"}},"example":{"error":{"code":"validation_error","message":"Missing required field: name","details":{"errors":[]}},"meta":{"request_id":"req_01JEXAMPLE","ts":"2026-08-21T00:00:00Z"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"validation_error","message":"Missing required field: name","details":{"errors":[]}},"meta":{"request_id":"req_01JEXAMPLE","ts":"2026-08-21T00:00:00Z"}}}},"exampleType":"generated"}},"headers":{"Retry-After":{"schema":{"type":"integer","minimum":0},"description":"Seconds until retry is permitted, when available."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Configured request limit."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0},"description":"Remaining requests in the current window."},"X-RateLimit-Reset":{"schema":{"type":"string","format":"date-time"},"description":"UTC time at which the current window resets."}},"exampleType":"generated"},"96fa1763-619c-4375-bfab-e71d62e41669":{"description":"Unexpected server failure. Use meta.request_id when contacting support.","content":{"application/json":{"schema":{"type":"object","required":["error","meta"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Stable machine-readable error code.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable explanation.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"oneOf":[{"description":"Structured, endpoint-specific details. Never rely on undocumented provider fields.","type":"object","uniqueKey":"error.details.oneOf.0","typeLabel":"object"},{"description":"Structured, endpoint-specific details. Never rely on undocumented provider fields.","type":"array","uniqueKey":"error.details.oneOf.1","typeLabel":"array"},{"description":"Structured, endpoint-specific details. Never rely on undocumented provider fields.","type":"null","uniqueKey":"error.details.oneOf.2","typeLabel":"null"}],"uniqueKey":"error.details","typeLabel":"object | array | null"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"meta":{"properties":{"request_id":{"type":"string","title":"Request Id","description":"Unique request identifier for support and debugging","isRequired":true,"uniqueKey":"meta.request_id","typeLabel":"string"},"ts":{"type":"string","format":"date-time","title":"Ts","description":"Server timestamp when the response was generated","isRequired":true,"uniqueKey":"meta.ts","typeLabel":"string\u003cdate-time>"}},"type":"object","required":["request_id","ts"],"title":"ResponseMeta","description":"Request correlation metadata.","isRequired":true,"uniqueKey":"meta","typeLabel":"ResponseMeta · object"}},"example":{"error":{"code":"validation_error","message":"Missing required field: name","details":{"errors":[]}},"meta":{"request_id":"req_01JEXAMPLE","ts":"2026-08-21T00:00:00Z"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"validation_error","message":"Missing required field: name","details":{"errors":[]}},"meta":{"request_id":"req_01JEXAMPLE","ts":"2026-08-21T00:00:00Z"}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"7d8bc2fe-bc9e-4992-b96d-a39b94ed3816":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"Your API key. Send in the Authorization header as: Bearer \u003cyour-api-key>","scopes":[]}}},"servers":{"57f5b051-6b39-4322-bc5e-d5cee6a37201":{"url":"https://api.truedy.ai/api/public/v1","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"Your API key. Send in the Authorization header as: Bearer \u003cyour-api-key>","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Your API key. Send in the Authorization header as: Bearer \u003cyour-api-key>","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"truedy","siteName":"Truedy API Documentation","title":"Create Call - Truedy API Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-03T13:14:27.724Z","originalFileLocation":"api-reference/calls/create-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=\"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 an outbound call. Direction is always outbound; organization is set from API key.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Truedy API Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/truedy/ScWMUm_PFf5yWmW_/_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/truedy/ScWMUm_PFf5yWmW_/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/truedy/ScWMUm_PFf5yWmW_/_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/truedy/ScWMUm_PFf5yWmW_/_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/truedy/ScWMUm_PFf5yWmW_/_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/truedy/ScWMUm_PFf5yWmW_/_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/truedy/ScWMUm_PFf5yWmW_/_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/truedy/ScWMUm_PFf5yWmW_/_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/truedy/ScWMUm_PFf5yWmW_/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create Call - Truedy API Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create an outbound call. Direction is always outbound; organization is set from API key.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Truedy API Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.truedy.ai/api-reference/calls/create-call\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://truedy.mintlify.app/_mintlify/api/og/v2?division=Calls\u0026amp;title=Create+Call\u0026amp;description=Create+an+outbound+call.+Direction+is+always+outbound%3B+organization+is+set+from+API+key.\u0026amp;theme=a9bb09b9b97075f640d7dc42\u0026amp;signature=c3743237a3deb7093f84c52242469ee5525a29cacce094d6ebfae3ef84f4e5fa\">\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 Call - Truedy API Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create an outbound call. Direction is always outbound; organization is set from API key.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://truedy.mintlify.app/_mintlify/api/og/v2?division=Calls\u0026amp;title=Create+Call\u0026amp;description=Create+an+outbound+call.+Direction+is+always+outbound%3B+organization+is+set+from+API+key.\u0026amp;theme=a9bb09b9b97075f640d7dc42\u0026amp;signature=c3743237a3deb7093f84c52242469ee5525a29cacce094d6ebfae3ef84f4e5fa\">\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/truedy/ScWMUm_PFf5yWmW_/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Truedy API Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#6366F1\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.truedy.ai/api-reference/calls/create-call\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/calls/create-call.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.truedy.ai/#organization\",\"name\":\"Truedy API Documentation\",\"url\":\"https://docs.truedy.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/truedy/WTUBrv0A4HPRDyoq/logo/truedy-light.png?fit=max\u0026auto=format\u0026n=WTUBrv0A4HPRDyoq\u0026q=85\u0026s=1523538b1cea9fc7da3b8863aa6278e3\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.truedy.ai#website\",\"name\":\"Truedy API Documentation\",\"url\":\"https://docs.truedy.ai\",\"publisher\":{\"@id\":\"https://docs.truedy.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.truedy.ai/api-reference/calls/create-call#webpage\",\"url\":\"https://docs.truedy.ai/api-reference/calls/create-call\",\"name\":\"Create Call\",\"description\":\"Create an outbound call. Direction is always outbound; organization is set from API key.\",\"dateModified\":\"2026-09-03T13:14:27.724Z\",\"isPartOf\":{\"@id\":\"https://docs.truedy.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.truedy.ai/api-reference/calls/create-call#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.truedy.ai/api-reference/calls/create-call#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoints\",\"item\":\"https://docs.truedy.ai/api-reference/agents/list-agents\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Calls\",\"item\":\"https://docs.truedy.ai/api-reference/calls/list-calls\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Create Call\",\"item\":\"https://docs.truedy.ai/api-reference/calls/create-call\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.truedy.ai/api-reference/calls/create-call#apireference\",\"headline\":\"Create Call\",\"name\":\"Create Call\",\"description\":\"Create an outbound call. Direction is always outbound; organization is set from API key.\",\"url\":\"https://docs.truedy.ai/api-reference/calls/create-call\",\"mainEntityOfPage\":{\"@id\":\"https://docs.truedy.ai/api-reference/calls/create-call#webpage\"},\"dateModified\":\"2026-09-03T13:14:27.724Z\",\"publisher\":{\"@id\":\"https://docs.truedy.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.truedy.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Truedy API Documentation\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Truedy API Documentation","nav":{"global":{"anchors":[{"anchor":"Documentation","icon":"book-open-cover","href":"https://docs.truedy.ai"},{"anchor":"API Reference","icon":"code","href":"https://docs.truedy.ai/api-reference"},{"anchor":"Support","icon":"headset","href":"mailto:support@truedy.ai"}]},"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":"/introduction"}]},{"tab":"API Reference","groups":[{"group":"API documentation","pages":[{"title":"API Reference","href":"/api-reference/introduction"},{"title":"Widgets","href":"/api-reference/widgets"},{"title":"Agent Templates","href":"/api-reference/agent-templates"},{"title":"Webhooks","href":"/api-reference/webhooks"},{"title":"Exports","href":"/api-reference/exports"},{"title":"Agent history","href":"/api-reference/agent-history"},{"title":"Workspaces","href":"/api-reference/workspaces"},{"title":"Calls","api":"/api/public/v1/calls","href":"/api-reference/calls"},{"title":"Knowledge (Native RAG)","api":"/api/public/v1/knowledge-spaces","href":"/api-reference/knowledge-spaces"},{"title":"Telephony","api":"/api/public/v1/telephony","href":"/api-reference/telephony"}]},{"group":"Endpoints","pages":[{"group":"Agents","pages":[{"title":"List Agents","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /agents","href":"/api-reference/agents/list-agents"},{"title":"Create Agent","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /agents","href":"/api-reference/agents/create-agent"},{"title":"Get Agent","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /agents/{agent_id}","href":"/api-reference/agents/get-agent"},{"title":"Delete Agent","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /agents/{agent_id}","href":"/api-reference/agents/delete-agent"},{"title":"Partial Update Agent","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /agents/{agent_id}","href":"/api-reference/agents/partial-update-agent"},{"title":"List Agent Versions","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /agents/{agent_id}/versions","href":"/api-reference/agents/list-agent-versions"}]},{"group":"Calls","pages":[{"title":"List Calls","description":"List calls for the organization with optional offset pagination.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /calls","href":"/api-reference/calls/list-calls"},{"title":"Create Call","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /calls","href":"/api-reference/calls/create-call"},{"title":"Get Call","description":"Get a call by ID.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /calls/{call_id}","href":"/api-reference/calls/get-call"},{"title":"Delete Call","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /calls/{call_id}","href":"/api-reference/calls/delete-call"},{"title":"Update Call","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /calls/{call_id}","href":"/api-reference/calls/update-call"},{"title":"Bulk Delete Calls","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /calls/bulk-delete","href":"/api-reference/calls/bulk-delete-calls"},{"title":"Get Call Recording","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /calls/{call_id}/recording","href":"/api-reference/calls/get-call-recording"},{"title":"Get Call Transcript","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /calls/{call_id}/transcript","href":"/api-reference/calls/get-call-transcript"},{"title":"Get Call Retention","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /calls/{call_id}/retention","href":"/api-reference/calls/get-call-retention"},{"title":"Update Call Retention","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /calls/{call_id}/retention","href":"/api-reference/calls/update-call-retention"},{"title":"Create Webrtc Call","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /webrtc/call","href":"/api-reference/calls/create-webrtc-call"}]},{"group":"Tools","pages":[{"title":"List Tools","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /tools","href":"/api-reference/tools/list-tools"},{"title":"Create Tool","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /tools","href":"/api-reference/tools/create-tool"},{"title":"Get Tool","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /tools/{tool_id}","href":"/api-reference/tools/get-tool"},{"title":"Delete Tool","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /tools/{tool_id}","href":"/api-reference/tools/delete-tool"},{"title":"Update Tool","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /tools/{tool_id}","href":"/api-reference/tools/update-tool"}]},{"group":"Knowledge Spaces","pages":[{"title":"List Spaces","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /knowledge-spaces","href":"/api-reference/knowledge-spaces/list-spaces"},{"title":"Create Space","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /knowledge-spaces","href":"/api-reference/knowledge-spaces/create-space"},{"title":"List Unified Resources","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /knowledge-spaces/unified","href":"/api-reference/knowledge-spaces/list-unified-resources"},{"title":"Get Space","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /knowledge-spaces/{space_id}","href":"/api-reference/knowledge-spaces/get-space"},{"title":"Archive Space","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /knowledge-spaces/{space_id}","href":"/api-reference/knowledge-spaces/archive-space"},{"title":"Update Space","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /knowledge-spaces/{space_id}","href":"/api-reference/knowledge-spaces/update-space"},{"title":"List Sources","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /knowledge-spaces/{space_id}/sources","href":"/api-reference/knowledge-spaces/list-sources"},{"title":"Create Source","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /knowledge-spaces/{space_id}/sources","href":"/api-reference/knowledge-spaces/create-source"},{"title":"Get Source","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /knowledge-spaces/{space_id}/sources/{source_id}","href":"/api-reference/knowledge-spaces/get-source"},{"title":"Archive Source","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /knowledge-spaces/{space_id}/sources/{source_id}","href":"/api-reference/knowledge-spaces/archive-source"},{"title":"Update Source","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /knowledge-spaces/{space_id}/sources/{source_id}","href":"/api-reference/knowledge-spaces/update-source"},{"title":"Create Upload Url","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /knowledge-spaces/{space_id}/sources/upload-url","href":"/api-reference/knowledge-spaces/create-upload-url"}]},{"group":"Voices","pages":[{"title":"List Voices","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /voices","href":"/api-reference/voices/list-voices"},{"title":"Create Voice","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /voices","href":"/api-reference/voices/create-voice"},{"title":"Get Voice","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /voices/{voice_id}","href":"/api-reference/voices/get-voice"},{"title":"Delete Voice","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /voices/{voice_id}","href":"/api-reference/voices/delete-voice"},{"title":"Update Voice","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /voices/{voice_id}","href":"/api-reference/voices/update-voice"},{"title":"Create Voice Clone","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /voices/clone","href":"/api-reference/voices/create-voice-clone"},{"title":"Repair voice provider connection","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /voices/{voice_id}/sync","href":"/api-reference/voices/repair-voice-provider-connection"},{"title":"Preview Voice","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /voices/{voice_id}/preview","href":"/api-reference/voices/preview-voice"}]},{"group":"Telephony","pages":[{"title":"List Phone Numbers","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /telephony/numbers","href":"/api-reference/telephony/list-phone-numbers"},{"title":"Search Numbers","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /telephony/numbers/search","href":"/api-reference/telephony/search-numbers"},{"title":"Purchase Number","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /telephony/numbers/purchase","href":"/api-reference/telephony/purchase-number"},{"title":"Assign Number To Agent","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /telephony/numbers/assign","href":"/api-reference/telephony/assign-number-to-agent"},{"title":"Unassign Number From Agent","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /telephony/numbers/unassign","href":"/api-reference/telephony/unassign-number-from-agent"},{"title":"Delete Phone Number","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /telephony/numbers/{number_id}","href":"/api-reference/telephony/delete-phone-number"},{"title":"Get Agent Numbers","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /telephony/agents/{agent_id}/numbers","href":"/api-reference/telephony/get-agent-numbers"},{"title":"Get Agent Webhook Url","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /telephony/agents/{agent_id}/webhook-url","href":"/api-reference/telephony/get-agent-webhook-url"}]},{"group":"Batch Calls","pages":[{"title":"List Batch Calls","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /batch-calls","href":"/api-reference/batch-calls/list-batch-calls"},{"title":"Create Batch Call","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /batch-calls","href":"/api-reference/batch-calls/create-batch-call"},{"title":"Bulk Delete Batch Calls","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /batch-calls/bulk-delete","href":"/api-reference/batch-calls/bulk-delete-batch-calls"},{"title":"List Batch Call Contacts","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /batch-calls/{batch_call_id}/contacts","href":"/api-reference/batch-calls/list-batch-call-contacts"},{"title":"Upload Batch Call Contacts","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /batch-calls/{batch_call_id}/contacts","href":"/api-reference/batch-calls/upload-batch-call-contacts"},{"title":"Get Batch Call","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /batch-calls/{batch_call_id}","href":"/api-reference/batch-calls/get-batch-call"},{"title":"Delete Batch Call","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /batch-calls/{batch_call_id}","href":"/api-reference/batch-calls/delete-batch-call"},{"title":"Update Batch Call","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /batch-calls/{batch_call_id}","href":"/api-reference/batch-calls/update-batch-call"},{"title":"Schedule Batch Call","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /batch-calls/{batch_call_id}/schedule","href":"/api-reference/batch-calls/schedule-batch-call"},{"title":"Pause Batch Call","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /batch-calls/{batch_call_id}/pause","href":"/api-reference/batch-calls/pause-batch-call"},{"title":"Resume Batch Call","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /batch-calls/{batch_call_id}/resume","href":"/api-reference/batch-calls/resume-batch-call"},{"title":"Cancel Batch Call","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /batch-calls/{batch_call_id}/cancel","href":"/api-reference/batch-calls/cancel-batch-call"}]},{"group":"Contacts","pages":[{"title":"List Contact Folders","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /contacts/folders","href":"/api-reference/contacts/list-contact-folders"},{"title":"Create Contact Folder","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /contacts/folders","href":"/api-reference/contacts/create-contact-folder"},{"title":"Delete Contact Folder","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /contacts/folders/{folder_id}","href":"/api-reference/contacts/delete-contact-folder"},{"title":"Update Contact Folder","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /contacts/folders/{folder_id}","href":"/api-reference/contacts/update-contact-folder"},{"title":"Import Contacts","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /contacts/import","href":"/api-reference/contacts/import-contacts"},{"title":"Export Contacts","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /contacts/export","href":"/api-reference/contacts/export-contacts"},{"title":"List Contacts","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /contacts","href":"/api-reference/contacts/list-contacts"},{"title":"Add Contact","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /contacts","href":"/api-reference/contacts/add-contact"},{"title":"Delete Contact","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /contacts/{contact_id}","href":"/api-reference/contacts/delete-contact"},{"title":"Update Contact","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /contacts/{contact_id}","href":"/api-reference/contacts/update-contact"},{"title":"Bulk Delete Contacts","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /contacts/bulk-delete","href":"/api-reference/contacts/bulk-delete-contacts"},{"title":"Bulk Update Contacts","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /contacts/bulk-update","href":"/api-reference/contacts/bulk-update-contacts"}]},{"group":"Widgets","pages":[{"title":"List Widgets","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /widgets","href":"/api-reference/widgets/list-widgets"},{"title":"Create Widget","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /widgets","href":"/api-reference/widgets/create-widget"},{"title":"Get Widget","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /widgets/{widget_id}","href":"/api-reference/widgets/get-widget"},{"title":"Delete Widget","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /widgets/{widget_id}","href":"/api-reference/widgets/delete-widget"},{"title":"Update Widget","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /widgets/{widget_id}","href":"/api-reference/widgets/update-widget"},{"title":"Get Widget Config","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /widgets/{widget_id}/public-config","href":"/api-reference/widgets/get-widget-config"}]},{"group":"Agent Templates","pages":[{"title":"List Agent Templates","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /agent-templates","href":"/api-reference/agent-templates/list-agent-templates"},{"title":"Get Agent Template","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /agent-templates/{template_id}","href":"/api-reference/agent-templates/get-agent-template"}]},{"group":"Webhooks","pages":[{"title":"List Webhooks","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /webhooks","href":"/api-reference/webhooks/list-webhooks"},{"title":"Create Webhook","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /webhooks","href":"/api-reference/webhooks/create-webhook"},{"title":"Get Webhook","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /webhooks/{webhook_id}","href":"/api-reference/webhooks/get-webhook"},{"title":"Delete Webhook","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /webhooks/{webhook_id}","href":"/api-reference/webhooks/delete-webhook"},{"title":"Update Webhook","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /webhooks/{webhook_id}","href":"/api-reference/webhooks/update-webhook"}]},{"group":"Exports","pages":[{"title":"Export Calls","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /exports/calls","href":"/api-reference/exports/export-calls"},{"title":"Export Campaigns","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /exports/campaigns","href":"/api-reference/exports/export-campaigns"}]},{"group":"Workspaces","pages":[{"title":"List Workspaces","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /workspaces","href":"/api-reference/workspaces/list-workspaces"},{"title":"Get Workspace","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /workspaces/{workspace_id}","href":"/api-reference/workspaces/get-workspace"},{"title":"Update Workspace","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /workspaces/{workspace_id}","href":"/api-reference/workspaces/update-workspace"}]}]}]},{"tab":"SDKs","pages":[{"title":"SDKs","href":"/sdks/curl"}]}]},"basePath":"","title":"Create Call - Truedy API Documentation","buildId":"dpl_G9nrg4qeJSZtah1Ziwbc2n6WkLch","deploymentId":"dpl_G9nrg4qeJSZtah1Ziwbc2n6WkLch","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-B7XKH4J3.js","utils-lOYzL7z-.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DF6jUUIM.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Dpsj5f7C.js","snippetPresets-CYeiDe8v.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CUFz1YZ_.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-D8H_iLS4.js","shallow-DdluZBHX.js","getApiPlaygroundDisplay-B9922vev.js","CodeSnippet-CMoRNGYs.js","CodeSnippets-DwyrPHuw.js","Page-DSVu9Ucl.js","getPastedJson-G-zIvlHh.js","icon-B03fnEy0.js","MethodPill-CW7teklc.js","DuplicateIcon-CtO8eekd.js","createIcon-DZTKdM_A.js","DynamicMarkdown-D5M2At0B.js","SectionHeading-C_2NaA2U.js","axios-vUo_bRtp.js","Markdown-D7QRHV3m.js","clsx-D1Z-ELXV.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-lvhuD9Du.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-CKfC4ywL.js"]}