Initiates an outbound AI phone call to an existing contact in your system. The contact’s phone number, name, and profile data are automatically retrieved — you only need to provide the contact ID, agent ID, and the phone number to call from.For calling any phone number without a pre-existing contact record, see Make AI Phone Call instead.
Headers
string
requerido
Your API key for authentication. Found in your dashboard under API settings.
Body
string
requerido
UUID of the existing contact to call. The contact’s phone number and profile data are fetched automatically. Use Get Contacts to look up contact IDs.
string
requerido
UUID of the AI agent to use for the call. Use List Agents to get available agents.
string
requerido
UUID of the phone number in your organization to call from. Use List Phone Numbers to get available number IDs.
array
Key-value pairs with extra context passed to the agent for this call (e.g. account balance, product name). Supplements the contact’s existing profile data.
Mostrar Additional data item
string
requerido
The key name (e.g. amount_debt).
string
requerido
The value (e.g. 14058).
Use schedule to choose a future calling time. The contact-call route currently does not apply delay to the call request.
object
Schedule the call for a specific date and time.
Mostrar Schedule object
string
requerido
Date and time of the call in yyyy-MM-dd HH:mm:ss format (e.g. 2026-06-15 14:30:00).
string
requerido
Timezone for the scheduled time (IANA format, e.g. America/New_York, America/Mexico_City).
object
Arbitrary key-value metadata to attach to the call for your own tracking purposes.
Response
The response is { "statusCode": number, "data": object }. The fields below describe data.
string
Unique identifier for the created call.
string
UUID of the AI agent handling the call.
string
UUID of the contact being called.
string
Timestamp when the call was created (ISO 8601).
Error Codes
400 Bad Request — Invalid or missing required fields
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/schema.json","name":"ContactShip Docs","colors":{"primary":"#0252ff","light":"#1E89FF","dark":"#0252ff"},"logo":{"light":"https://mintcdn.com/contactship/XJKLcqzvszyHAh2b/logo/Isologotipo.png?fit=max\u0026auto=format\u0026n=XJKLcqzvszyHAh2b\u0026q=85\u0026s=1100afd12fc8debe15faade6766a53c7","dark":"https://mintcdn.com/contactship/XJKLcqzvszyHAh2b/logo/Isologotipo.png?fit=max\u0026auto=format\u0026n=XJKLcqzvszyHAh2b\u0026q=85\u0026s=1100afd12fc8debe15faade6766a53c7"},"favicon":"https://mintcdn.com/contactship/XJKLcqzvszyHAh2b/favicon2.png?fit=max\u0026auto=format\u0026n=XJKLcqzvszyHAh2b\u0026q=85\u0026s=2522034f500b8c3c60f46aed56daad87","api":{"mdx":{"auth":{"method":"key","name":"x-api-key"},"server":"https://api.contactship.ai"}},"styling":{"latex":false},"navigation":{"languages":[{"language":"es","default":true,"href":"es/comenzar/que-es-contactship"},{"language":"en","href":"en/get-started/what-is-contactship"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"contactship","hasAudioNarration":false,"actualSubdomain":"contactship","customDomains":["docs.contactship.ai"],"gitSource":{"type":"github","owner":"serranomatias","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{},"buildId":"6afddde1e3a51766e8138724","clientVersion":"0.0.4205","searchFilterCounts":[{"language":"en","tag":"Documentation","count":87},{"language":"es","tag":"Documentación","count":87},{"language":"default","tag":"API Reference","count":52},{"language":"en","tag":"Integrations","count":13},{"language":"es","tag":"Integraciones","count":13},{"language":"default","tag":"Contactos","count":12},{"language":"en","tag":"Use cases","count":12},{"language":"es","tag":"Casos de uso","count":12},{"language":"en","tag":"Voice agents","count":10},{"language":"es","tag":"Agentes de voz","count":10},{"language":"en","tag":"Contacts","count":8},{"language":"en","tag":"Messages","count":8},{"language":"es","tag":"Contactos","count":8},{"language":"es","tag":"Mensajes","count":8},{"language":"en","tag":"Get started","count":7},{"language":"en","tag":"Organization","count":7},{"language":"es","tag":"Comenzar","count":7},{"language":"es","tag":"Organización","count":7},{"language":"default","tag":"Agentes","count":6},{"language":"default","tag":"Canales y conversaciones","count":6},{"language":"default","tag":"Documentación API","count":6},{"language":"en","tag":"Calls","count":6},{"language":"en","tag":"Text agents","count":6},{"language":"es","tag":"Agentes de texto","count":6},{"language":"es","tag":"Llamadas","count":6},{"language":"default","tag":"WhatsApp (WABA)","count":5},{"language":"default","tag":"Etiquetas","count":4},{"language":"default","tag":"Llamadas","count":4},{"language":"default","tag":"Tareas","count":3},{"language":"default","tag":"Eventos","count":2}]},"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":"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":[{"filePath":"globals.css","content":".rounded-image{border-radius:8px}"}],"page":{"pagePath":"api-reference/endpoint/make-contact-call","slug":"/api-reference/endpoint/make-contact-call","pageMetadata":{"title":"Call a Contact","api":"POST /v1/calls/single-contact-call","description":"Initiate an outbound AI phone call to an existing contact","href":"/api-reference/endpoint/make-contact-call"},"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: \"Initiate an outbound AI phone call to an existing contact\"\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={a:`a`,code:`code`,li:`li`,p:`p`,ul:`ul`,..._provideComponents(),...props.components},{Expandable,Heading,Note,ParamField,ResponseField}=_components;if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Initiates an outbound AI phone call to an existing contact in your system. The contact’s phone number, name, and profile data are automatically retrieved — you only need to provide the contact ID, agent ID, and the phone number to call from.`}),`\n`,_jsxs(_components.p,{children:[`For calling any phone number without a pre-existing contact record, see `,_jsx(_components.a,{href:`/api-reference/endpoint/make-ai-phone-call`,children:`Make AI Phone Call`}),` instead.`]}),`\n`,_jsx(Heading,{level:`2`,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:`Your API key for authentication. Found in your dashboard under API settings.`})}),`\n`,_jsx(Heading,{level:`2`,id:`body`,children:`Body`}),`\n`,_jsx(ParamField,{body:`contact_id`,type:`string`,required:true,id:`param-contact-id`,children:_jsxs(_components.p,{children:[`UUID of the existing contact to call. The contact’s phone number and profile data are fetched automatically. Use `,_jsx(_components.a,{href:`/api-reference/endpoint/get-contacts`,children:`Get Contacts`}),` to look up contact IDs.`]})}),`\n`,_jsx(ParamField,{body:`agent_id`,type:`string`,required:true,id:`param-agent-id`,children:_jsxs(_components.p,{children:[`UUID of the AI agent to use for the call. Use `,_jsx(_components.a,{href:`/api-reference/endpoint/list-agents`,children:`List Agents`}),` to get available agents.`]})}),`\n`,_jsx(ParamField,{body:`from_number_id`,type:`string`,required:true,id:`param-from-number-id`,children:_jsxs(_components.p,{children:[`UUID of the phone number in your organization to call from. Use `,_jsx(_components.a,{href:`/api-reference/endpoint/get-phone-numbers`,children:`List Phone Numbers`}),` to get available number IDs.`]})}),`\n`,_jsxs(ParamField,{body:`additional_data`,type:`array`,id:`param-additional-data`,children:[_jsx(_components.p,{children:`Key-value pairs with extra context passed to the agent for this call (e.g. account balance, product name). Supplements the contact’s existing profile data.`}),_jsxs(Expandable,{title:`Additional data item`,children:[_jsx(ParamField,{body:`key`,type:`string`,required:true,id:`param-key`,children:_jsxs(_components.p,{children:[`The key name (e.g. `,_jsx(_components.code,{children:`amount_debt`}),`).`]})}),_jsx(ParamField,{body:`value`,type:`string`,required:true,id:`param-value`,children:_jsxs(_components.p,{children:[`The value (e.g. `,_jsx(_components.code,{children:`14058`}),`).`]})})]})]}),`\n`,_jsxs(Note,{children:[`Use `,_jsx(_components.code,{children:`schedule`}),` to choose a future calling time. The contact-call route currently does not apply `,_jsx(_components.code,{children:`delay`}),` to the call request.`]}),`\n`,_jsxs(ParamField,{body:`schedule`,type:`object`,id:`param-schedule`,children:[_jsx(_components.p,{children:`Schedule the call for a specific date and time.`}),_jsxs(Expandable,{title:`Schedule object`,children:[_jsx(ParamField,{body:`scheduled_call_time`,type:`string`,required:true,id:`param-scheduled-call-time`,children:_jsxs(_components.p,{children:[`Date and time of the call in `,_jsx(_components.code,{children:`yyyy-MM-dd HH:mm:ss`}),` format (e.g. `,_jsx(_components.code,{children:`2026-06-15 14:30:00`}),`).`]})}),_jsx(ParamField,{body:`timezone`,type:`string`,required:true,id:`param-timezone`,children:_jsxs(_components.p,{children:[`Timezone for the scheduled time (IANA format, e.g. `,_jsx(_components.code,{children:`America/New_York`}),`, `,_jsx(_components.code,{children:`America/Mexico_City`}),`).`]})})]})]}),`\n`,_jsx(ParamField,{body:`metadata`,type:`object`,id:`param-metadata`,children:_jsx(_components.p,{children:`Arbitrary key-value metadata to attach to the call for your own tracking purposes.`})}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsxs(_components.p,{children:[`The response is `,_jsx(_components.code,{children:`{ \"statusCode\": number, \"data\": object }`}),`. The fields below describe `,_jsx(_components.code,{children:`data`}),`.`]}),`\n`,_jsx(ResponseField,{name:`call_id`,type:`string`,id:`param-call-id`,children:_jsx(_components.p,{children:`Unique identifier for the created call.`})}),`\n`,_jsx(ResponseField,{name:`agent_id`,type:`string`,id:`param-agent-id-1`,children:_jsx(_components.p,{children:`UUID of the AI agent handling the call.`})}),`\n`,_jsx(ResponseField,{name:`contact_id`,type:`string`,id:`param-contact-id-1`,children:_jsx(_components.p,{children:`UUID of the contact being called.`})}),`\n`,_jsx(ResponseField,{name:`created_at`,type:`string`,id:`param-created-at`,children:_jsx(_components.p,{children:`Timestamp when the call was created (ISO 8601).`})}),`\n`,_jsx(Heading,{level:`2`,id:`error-codes`,children:`Error Codes`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`400 Bad Request`}),` — Invalid or missing required fields`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`401 Unauthorized`}),` — Invalid or missing API key`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`404 Not Found`}),` — Contact or phone number not found`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`500 Internal Server Error`}),` — Server-side error`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`code-examples`,children:`Code Examples`})]})}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":"Call a Contact","api":"POST /v1/calls/single-contact-call","description":"Initiate an outbound AI phone call to an existing contact","href":"/api-reference/endpoint/make-contact-call"}}},"mdxSourceWithNoJs":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Expandable,Heading,Note,ParamField,RequestExample,ResponseExample,ResponseField}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!RequestExample)_missingMdxReference(`RequestExample`,true);if(!ResponseExample)_missingMdxReference(`ResponseExample`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Initiates an outbound AI phone call to an existing contact in your system. The contact’s phone number, name, and profile data are automatically retrieved — you only need to provide the contact ID, agent ID, and the phone number to call from.`}),`\n`,_jsxs(_components.p,{children:[`For calling any phone number without a pre-existing contact record, see `,_jsx(_components.a,{href:`/api-reference/endpoint/make-ai-phone-call`,children:`Make AI Phone Call`}),` instead.`]}),`\n`,_jsx(Heading,{level:`2`,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:`Your API key for authentication. Found in your dashboard under API settings.`})}),`\n`,_jsx(Heading,{level:`2`,id:`body`,children:`Body`}),`\n`,_jsx(ParamField,{body:`contact_id`,type:`string`,required:true,id:`param-contact-id`,children:_jsxs(_components.p,{children:[`UUID of the existing contact to call. The contact’s phone number and profile data are fetched automatically. Use `,_jsx(_components.a,{href:`/api-reference/endpoint/get-contacts`,children:`Get Contacts`}),` to look up contact IDs.`]})}),`\n`,_jsx(ParamField,{body:`agent_id`,type:`string`,required:true,id:`param-agent-id`,children:_jsxs(_components.p,{children:[`UUID of the AI agent to use for the call. Use `,_jsx(_components.a,{href:`/api-reference/endpoint/list-agents`,children:`List Agents`}),` to get available agents.`]})}),`\n`,_jsx(ParamField,{body:`from_number_id`,type:`string`,required:true,id:`param-from-number-id`,children:_jsxs(_components.p,{children:[`UUID of the phone number in your organization to call from. Use `,_jsx(_components.a,{href:`/api-reference/endpoint/get-phone-numbers`,children:`List Phone Numbers`}),` to get available number IDs.`]})}),`\n`,_jsxs(ParamField,{body:`additional_data`,type:`array`,id:`param-additional-data`,children:[_jsx(_components.p,{children:`Key-value pairs with extra context passed to the agent for this call (e.g. account balance, product name). Supplements the contact’s existing profile data.`}),_jsxs(Expandable,{title:`Additional data item`,children:[_jsx(ParamField,{body:`key`,type:`string`,required:true,id:`param-key`,children:_jsxs(_components.p,{children:[`The key name (e.g. `,_jsx(_components.code,{children:`amount_debt`}),`).`]})}),_jsx(ParamField,{body:`value`,type:`string`,required:true,id:`param-value`,children:_jsxs(_components.p,{children:[`The value (e.g. `,_jsx(_components.code,{children:`14058`}),`).`]})})]})]}),`\n`,_jsxs(Note,{children:[`Use `,_jsx(_components.code,{children:`schedule`}),` to choose a future calling time. The contact-call route currently does not apply `,_jsx(_components.code,{children:`delay`}),` to the call request.`]}),`\n`,_jsxs(ParamField,{body:`schedule`,type:`object`,id:`param-schedule`,children:[_jsx(_components.p,{children:`Schedule the call for a specific date and time.`}),_jsxs(Expandable,{title:`Schedule object`,children:[_jsx(ParamField,{body:`scheduled_call_time`,type:`string`,required:true,id:`param-scheduled-call-time`,children:_jsxs(_components.p,{children:[`Date and time of the call in `,_jsx(_components.code,{children:`yyyy-MM-dd HH:mm:ss`}),` format (e.g. `,_jsx(_components.code,{children:`2026-06-15 14:30:00`}),`).`]})}),_jsx(ParamField,{body:`timezone`,type:`string`,required:true,id:`param-timezone`,children:_jsxs(_components.p,{children:[`Timezone for the scheduled time (IANA format, e.g. `,_jsx(_components.code,{children:`America/New_York`}),`, `,_jsx(_components.code,{children:`America/Mexico_City`}),`).`]})})]})]}),`\n`,_jsx(ParamField,{body:`metadata`,type:`object`,id:`param-metadata`,children:_jsx(_components.p,{children:`Arbitrary key-value metadata to attach to the call for your own tracking purposes.`})}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsxs(_components.p,{children:[`The response is `,_jsx(_components.code,{children:`{ \"statusCode\": number, \"data\": object }`}),`. The fields below describe `,_jsx(_components.code,{children:`data`}),`.`]}),`\n`,_jsx(ResponseField,{name:`call_id`,type:`string`,id:`param-call-id`,children:_jsx(_components.p,{children:`Unique identifier for the created call.`})}),`\n`,_jsx(ResponseField,{name:`agent_id`,type:`string`,id:`param-agent-id-1`,children:_jsx(_components.p,{children:`UUID of the AI agent handling the call.`})}),`\n`,_jsx(ResponseField,{name:`contact_id`,type:`string`,id:`param-contact-id-1`,children:_jsx(_components.p,{children:`UUID of the contact being called.`})}),`\n`,_jsx(ResponseField,{name:`created_at`,type:`string`,id:`param-created-at`,children:_jsx(_components.p,{children:`Timestamp when the call was created (ISO 8601).`})}),`\n`,_jsx(Heading,{level:`2`,id:`error-codes`,children:`Error Codes`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`400 Bad Request`}),` — Invalid or missing required fields`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`401 Unauthorized`}),` — Invalid or missing API key`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`404 Not Found`}),` — Contact or phone number not found`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`500 Internal Server Error`}),` — Server-side error`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`code-examples`,children:`Code Examples`}),`\n`,_jsxs(RequestExample,{children:[_jsx(CodeBlock,{filename:`cURL — Immediate call`,numberOfLines:`11`,language:`shellscript`,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:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`11`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.contactship.ai/v1/calls/single-contact-call\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"x-api-key: your-api-key\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"contact_id\": \"c1d2e3f4-a5b6-7890-cdef-123456789012\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"agent_id\": \"a1b2c3d4-e5f6-4890-abcd-ef1234567890\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"from_number_id\": \"b1b2c3d4-e5f6-4890-abcd-ef1234567890\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"additional_data\": [`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` { \"key\": \"amount_debt\", \"value\": \"14058\" }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` ]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`cURL — Scheduled call`,numberOfLines:`12`,language:`shellscript`,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:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`12`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.contactship.ai/v1/calls/single-contact-call\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"x-api-key: your-api-key\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"contact_id\": \"c1d2e3f4-a5b6-7890-cdef-123456789012\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"agent_id\": \"a1b2c3d4-e5f6-4890-abcd-ef1234567890\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"from_number_id\": \"b1b2c3d4-e5f6-4890-abcd-ef1234567890\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"schedule\": {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"scheduled_call_time\": \"2026-06-15 10:00:00\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"timezone\": \"America/Mexico_City\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`JavaScript`,numberOfLines:`20`,language:`javascript`,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:`javascript`,children:_jsxs(_components.code,{language:`javascript`,numberOfLines:`20`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` response`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` fetch`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'https://api.contactship.ai/v1/calls/single-contact-call'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_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:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` method:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'POST'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` headers:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'x-api-key'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'your-api-key'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Content-Type'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'application/json'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_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:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` body:`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` JSON`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`stringify`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`({`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` contact_id:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'c1d2e3f4-a5b6-7890-cdef-123456789012'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` agent_id:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'a1b2c3d4-e5f6-4890-abcd-ef1234567890'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` from_number_id:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'b1b2c3d4-e5f6-4890-abcd-ef1234567890'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` additional_data:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` [`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`key:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'amount_debt'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`value:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '14058'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ],`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }),`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_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:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:`data`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:`call`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` } `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` response`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`json`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`();`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`console`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`log`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:\"`Call created: \"}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:\"${\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`call`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`call_id`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:\"`\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`Python`,numberOfLines:`16`,language:`python`,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:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`16`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` requests`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`response `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` requests.post(`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'https://api.contactship.ai/v1/calls/single-contact-call'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` headers`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'x-api-key'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'your-api-key'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`},`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` json`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'contact_id'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'c1d2e3f4-a5b6-7890-cdef-123456789012'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'agent_id'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'a1b2c3d4-e5f6-4890-abcd-ef1234567890'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'from_number_id'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'b1b2c3d4-e5f6-4890-abcd-ef1234567890'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'additional_data'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'key'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'amount_debt'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'value'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'14058'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`},`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ],`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_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:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`call `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` response.json()[`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`]`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:`print`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`f`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Call created: `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`{`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`call[`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'call_id'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`]`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})]}),`\n`]})})})]}),`\n`,_jsx(ResponseExample,{children:_jsx(CodeBlock,{filename:`Example Response`,numberOfLines:`9`,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:`9`,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:` \"statusCode\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`201`}),_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:` \"data\"`}),_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:`\"call-b2c3d4e5-f6a7-8901-bcde-f12345678901\"`}),_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:` \"agent_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"a1b2c3d4-e5f6-4890-abcd-ef1234567890\"`}),_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:` \"contact_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"c1d2e3f4-a5b6-7890-cdef-123456789012\"`}),_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:` \"created_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-04-06T15:05:00Z\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})})]})}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":"Call a Contact","api":"POST /v1/calls/single-contact-call","description":"Initiate an outbound AI phone call to an existing contact","href":"/api-reference/endpoint/make-contact-call"}}}},"mdxExtracts":{"tableOfContents":[{"title":"Headers","slug":"headers","depth":2,"children":[]},{"title":"Body","slug":"body","depth":2,"children":[]},{"title":"Response","slug":"response","depth":2,"children":[]},{"title":"Error Codes","slug":"error-codes","depth":2,"children":[]},{"title":"Code Examples","slug":"code-examples","depth":2,"children":[]}],"codeExamples":{"request":{"type":"RequestExample","children":[{"filename":"cURL — Immediate call","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=\"shellscript\">\u003ccode language=\"shellscript\" numberOfLines=\"11\">\u003cspan class=\"line\">\u003cspan style=\"color:#953800;--shiki-dark:#DCDCAA\">curl\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -X\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> POST\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"https://api.contactship.ai/v1/calls/single-contact-call\"\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -H\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"x-api-key: your-api-key\"\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -H\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"Content-Type: application/json\"\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -d\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> '{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"contact_id\": \"c1d2e3f4-a5b6-7890-cdef-123456789012\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"agent_id\": \"a1b2c3d4-e5f6-4890-abcd-ef1234567890\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"from_number_id\": \"b1b2c3d4-e5f6-4890-abcd-ef1234567890\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"additional_data\": [\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> { \"key\": \"amount_debt\", \"value\": \"14058\" }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> ]\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> }'\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"cURL — Scheduled call","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=\"shellscript\">\u003ccode language=\"shellscript\" numberOfLines=\"12\">\u003cspan class=\"line\">\u003cspan style=\"color:#953800;--shiki-dark:#DCDCAA\">curl\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -X\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> POST\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"https://api.contactship.ai/v1/calls/single-contact-call\"\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -H\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"x-api-key: your-api-key\"\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -H\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"Content-Type: application/json\"\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -d\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> '{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"contact_id\": \"c1d2e3f4-a5b6-7890-cdef-123456789012\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"agent_id\": \"a1b2c3d4-e5f6-4890-abcd-ef1234567890\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"from_number_id\": \"b1b2c3d4-e5f6-4890-abcd-ef1234567890\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"schedule\": {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"scheduled_call_time\": \"2026-06-15 10:00:00\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"timezone\": \"America/Mexico_City\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> }'\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"JavaScript","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=\"javascript\">\u003ccode language=\"javascript\" numberOfLines=\"20\">\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">const\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#4FC1FF\"> response\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\"> =\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\"> await\u003c/span>\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\"> fetch\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">(\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'https://api.contactship.ai/v1/calls/single-contact-call'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> method:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'POST'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> headers:\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'x-api-key'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'your-api-key'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'Content-Type'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'application/json'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> body:\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#4FC1FF\"> JSON\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\">stringify\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">({\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> contact_id:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'c1d2e3f4-a5b6-7890-cdef-123456789012'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> agent_id:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'a1b2c3d4-e5f6-4890-abcd-ef1234567890'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> from_number_id:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'b1b2c3d4-e5f6-4890-abcd-ef1234567890'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> additional_data:\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> [\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> { \u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">key:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'amount_debt'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, \u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">value:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> '14058'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> ],\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }),\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">);\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">const\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> { \u003c/span>\u003cspan style=\"color:#953800;--shiki-dark:#9CDCFE\">data\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#4FC1FF\">call\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> } \u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\">=\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\"> await\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> response\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\">json\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">();\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">console\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\">log\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">(\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">`Call created: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#569CD6\">${\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">call\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">call_id\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#569CD6\">}\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">`\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">);\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"Python","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=\"python\">\u003ccode language=\"python\" numberOfLines=\"16\">\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\">import\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> requests\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">response \u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\">=\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> requests.post(\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'https://api.contactship.ai/v1/calls/single-contact-call'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#953800;--shiki-dark:#9CDCFE\"> headers\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\">=\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'x-api-key'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'your-api-key'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">},\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#953800;--shiki-dark:#9CDCFE\"> json\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\">=\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'contact_id'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'c1d2e3f4-a5b6-7890-cdef-123456789012'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'agent_id'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'a1b2c3d4-e5f6-4890-abcd-ef1234567890'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'from_number_id'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'b1b2c3d4-e5f6-4890-abcd-ef1234567890'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'additional_data'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: [\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> {\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'key'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'amount_debt'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'value'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'14058'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">},\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> ],\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">)\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">call \u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\">=\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> response.json()[\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"data\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">]\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#DCDCAA\">print\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">(\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">f\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Call created: \u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">{\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">call[\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'call_id'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">]\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">}\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">)\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]},"response":{"type":"ResponseExample","children":[{"filename":"Example Response","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=\"9\">\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\"> \"statusCode\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">201\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"data\"\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\">\"call-b2c3d4e5-f6a7-8901-bcde-f12345678901\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"agent_id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"a1b2c3d4-e5f6-4890-abcd-ef1234567890\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"contact_id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"c1d2e3f4-a5b6-7890-cdef-123456789012\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"created_at\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"2026-04-06T15:05:00Z\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\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":"Call a Contact","path":"/v1/calls/single-contact-call","method":"post","request":{"security":[],"parameters":{"query":{},"header":{"x-api-key":{"schema":[{"type":"string","description":"Your API key for authentication. Found in your dashboard under API settings.","required":true}]}},"cookie":{},"path":{}},"body":{"application/json":{"schemaArray":[{"type":"object","properties":{"contact_id":[{"type":"string","description":"UUID of the existing contact to call. The contact’s phone number and profile data are fetched automatically. Use Get Contacts to look up contact IDs.","required":true}],"agent_id":[{"type":"string","description":"UUID of the AI agent to use for the call. Use List Agents to get available agents.","required":true}],"from_number_id":[{"type":"string","description":"UUID of the phone number in your organization to call from. Use List Phone Numbers to get available number IDs.","required":true}],"additional_data":[{"type":"array","items":[{"type":"object","properties":{"key":[{"type":"string","description":"The key name (e.g. `amount_debt` ).","required":true}],"value":[{"type":"string","description":"The value (e.g. `14058` ).","required":true}]}}],"description":"Key-value pairs with extra context passed to the agent for this call (e.g. account balance, product name). Supplements the contact’s existing profile data."}],"schedule":[{"type":"object","properties":{"scheduled_call_time":[{"type":"string","description":"Date and time of the call in `yyyy-MM-dd HH:mm:ss` format (e.g. `2026-06-15 14:30:00` ).","required":true}],"timezone":[{"type":"string","description":"Timezone for the scheduled time (IANA format, e.g. `America/New_York` , `America/Mexico_City` ).","required":true}]},"description":"Schedule the call for a specific date and time."}],"metadata":[{"type":"object","properties":{},"description":"Arbitrary key-value metadata to attach to the call for your own tracking purposes."}]}}],"examples":{"example":{"value":{"contact_id":"\u003cstring>","agent_id":"\u003cstring>","from_number_id":"\u003cstring>","additional_data":[{"key":"\u003cstring>","value":"\u003cstring>"}],"schedule":{"scheduled_call_time":"\u003cstring>","timezone":"\u003cstring>"},"metadata":{}}}}}}},"response":{"200":{"application/json":{"schemaArray":[{"type":"object","properties":{"call_id":[{"type":"string","description":"Unique identifier for the created call."}],"agent_id":[{"type":"string","description":"UUID of the AI agent handling the call."}],"contact_id":[{"type":"string","description":"UUID of the contact being called."}],"created_at":[{"type":"string","description":"Timestamp when the call was created (ISO 8601)."}]}}],"examples":{"example":{"value":{"call_id":"\u003cstring>","agent_id":"\u003cstring>","contact_id":"\u003cstring>","created_at":"\u003cstring>"}}}}}},"deprecated":false}},"jsLinks":[],"subdomain":"contactship","siteName":"ContactShip Docs","title":"Call a Contact - ContactShip Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"es":{"href":"/api-reference/endpoint/make-contact-call","matchLevel":0},"en":{"href":"/api-reference/endpoint/make-contact-call","matchLevel":0}}},"lastModified":"2026-09-07T07:53:00.498Z","originalFileLocation":"api-reference/endpoint/make-contact-call.mdx","locale":"es"},"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=\"Initiate an outbound AI phone call to an existing contact\">\u003cmeta data-mint-head name=\"application-name\" content=\"ContactShip Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/contactship/t9ds7rwKwjlbXW3P/_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/contactship/t9ds7rwKwjlbXW3P/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/contactship/t9ds7rwKwjlbXW3P/_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/contactship/t9ds7rwKwjlbXW3P/_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/contactship/t9ds7rwKwjlbXW3P/_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/contactship/t9ds7rwKwjlbXW3P/_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/contactship/t9ds7rwKwjlbXW3P/_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/contactship/t9ds7rwKwjlbXW3P/_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/contactship/t9ds7rwKwjlbXW3P/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Call a Contact - ContactShip Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Initiate an outbound AI phone call to an existing contact\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"ContactShip Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.contactship.ai/api-reference/endpoint/make-contact-call\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://contactship.mintlify.site/_mintlify/api/og/v2?division=Voz\u0026amp;title=Call+a+Contact\u0026amp;description=Initiate+an+outbound+AI+phone+call+to+an+existing+contact\u0026amp;theme=a06d13b3f4cf8a7c17fe2657\u0026amp;signature=ab31c731e6dec902bc85ac9e7d6b5edb32d57c51f82320f37ec358417d79f61b\">\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=\"Call a Contact - ContactShip Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Initiate an outbound AI phone call to an existing contact\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://contactship.mintlify.site/_mintlify/api/og/v2?division=Voz\u0026amp;title=Call+a+Contact\u0026amp;description=Initiate+an+outbound+AI+phone+call+to+an+existing+contact\u0026amp;theme=a06d13b3f4cf8a7c17fe2657\u0026amp;signature=ab31c731e6dec902bc85ac9e7d6b5edb32d57c51f82320f37ec358417d79f61b\">\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/contactship/t9ds7rwKwjlbXW3P/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"ContactShip Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0252ff\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.contactship.ai/api-reference/endpoint/make-contact-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/endpoint/make-contact-call.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.contactship.ai/#organization\",\"name\":\"ContactShip Docs\",\"url\":\"https://docs.contactship.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/contactship/XJKLcqzvszyHAh2b/logo/Isologotipo.png?fit=max\u0026auto=format\u0026n=XJKLcqzvszyHAh2b\u0026q=85\u0026s=1100afd12fc8debe15faade6766a53c7\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.contactship.ai#website\",\"name\":\"ContactShip Docs\",\"url\":\"https://docs.contactship.ai\",\"publisher\":{\"@id\":\"https://docs.contactship.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.contactship.ai/api-reference/endpoint/make-contact-call#webpage\",\"url\":\"https://docs.contactship.ai/api-reference/endpoint/make-contact-call\",\"name\":\"Call a Contact\",\"description\":\"Initiate an outbound AI phone call to an existing contact\",\"dateModified\":\"2026-09-07T07:53:00.498Z\",\"isPartOf\":{\"@id\":\"https://docs.contactship.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.contactship.ai/api-reference/endpoint/make-contact-call#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.contactship.ai/api-reference/endpoint/make-contact-call#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Voz\",\"item\":\"https://docs.contactship.ai/api-reference/endpoint/make-ai-phone-call\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Call a Contact\",\"item\":\"https://docs.contactship.ai/api-reference/endpoint/make-contact-call\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.contactship.ai/api-reference/endpoint/make-contact-call#apireference\",\"headline\":\"Call a Contact\",\"name\":\"Call a Contact\",\"description\":\"Initiate an outbound AI phone call to an existing contact\",\"url\":\"https://docs.contactship.ai/api-reference/endpoint/make-contact-call\",\"mainEntityOfPage\":{\"@id\":\"https://docs.contactship.ai/api-reference/endpoint/make-contact-call#webpage\"},\"dateModified\":\"2026-09-07T07:53:00.498Z\",\"publisher\":{\"@id\":\"https://docs.contactship.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.contactship.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"ContactShip Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"ContactShip Docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/endpoint/make-contact-call.md","siteName":"ContactShip Docs","nav":{"global":null,"languages":[{"language":"es","default":true,"tabs":[{"tab":"Documentación","pages":[{"title":"Documentación","href":"/es/comenzar/que-es-contactship"}]},{"tab":"Casos de uso","pages":[{"title":"Casos de uso","href":"/es/casos-de-uso"}]},{"tab":"API Reference","groups":[{"group":"Documentación API","pages":[{"title":"API Introduction","href":"/api-reference/introduction"},{"title":"Rate Limits and Retries","href":"/api-reference/rate-limits"},{"title":"Call webhook payload","href":"/api-reference/webhooks"},{"title":"Inbound context webhook","href":"/api-reference/inbound-webhook"},{"title":"Follow-up closure webhook","href":"/api-reference/follow-up-webhook"},{"title":"HTTP tool execution","href":"/api-reference/tool-execution"}]},{"group":"Voz","pages":[{"title":"Make AI Phone Call","api":"POST /v1/calls/single-phone-call","description":"Initiate an outbound AI phone call using raw phone numbers","href":"/api-reference/endpoint/make-ai-phone-call"},{"title":"Call a Contact","api":"POST /v1/calls/single-contact-call","href":"/api-reference/endpoint/make-contact-call"}]},{"group":"WhatsApp (WABA)","pages":[{"title":"Send WhatsApp Message","api":"POST /v1/waba/send","description":"Send a text message to a contact via WhatsApp Business API (WABA)","href":"/api-reference/endpoint/waba-send-message"},{"title":"Send WhatsApp Template","api":"POST /v1/waba/send-template","href":"/api-reference/endpoint/waba-send-template"},{"title":"Send WhatsApp Media","api":"POST /v1/waba/send-media","href":"/api-reference/endpoint/waba-send-media"},{"title":"Send WhatsApp Location","api":"POST /v1/waba/send-location","href":"/api-reference/endpoint/waba-send-location"},{"title":"Get WhatsApp Templates","api":"GET /v1/waba/templates","href":"/api-reference/endpoint/waba-get-templates"}]},{"group":"Canales y conversaciones","pages":[{"title":"List Channels","api":"GET /v1/channels","href":"/api-reference/endpoint/get-channels"},{"title":"List Conversations","api":"GET /v1/conversations","href":"/api-reference/endpoint/list-conversations"},{"title":"Get Thread","api":"GET /v1/thread/{threadId}","href":"/api-reference/endpoint/get-thread"},{"title":"List Thread Messages","api":"GET /v1/thread/{threadId}/messages","href":"/api-reference/endpoint/get-thread-messages"},{"title":"Update Thread","api":"PUT /v1/thread/{threadId}","href":"/api-reference/endpoint/update-thread"},{"title":"Get Message","api":"GET /v1/messages/{messageId}","href":"/api-reference/endpoint/get-message"}]},{"group":"Organización","pages":[{"title":"Get Credits","api":"GET /v1/credits","href":"/api-reference/endpoint/get-credits"}]},{"group":"Agentes","pages":[{"title":"Create Agent","api":"POST /v1/agents","href":"/api-reference/endpoint/create-agent"},{"title":"Get Agent","api":"GET /v1/agents/{agentId}","href":"/api-reference/endpoint/get-agent"},{"title":"List Agents","api":"GET /v1/agents","href":"/api-reference/endpoint/list-agents"},{"title":"Update Agent","api":"PUT /v1/agents/{agentId}","href":"/api-reference/endpoint/update-agent"},{"title":"Delete Agent","api":"DELETE /v1/agents/{agentId}","href":"/api-reference/endpoint/delete-agent"},{"title":"List Voices","api":"GET /v1/agents/voices","href":"/api-reference/endpoint/list-voices"}]},{"group":"Contactos","pages":[{"title":"Get Contacts","api":"GET /v1/contacts","href":"/api-reference/endpoint/get-contacts"},{"title":"Create Contact","api":"POST /v1/contacts","href":"/api-reference/endpoint/create-contact"},{"title":"Get Contact by Identifier","api":"GET /v1/contacts/{identifier}","href":"/api-reference/endpoint/get-contact-by-identifier"},{"title":"Get Contact Call History","api":"GET /v1/contacts/{contactId}/call-history","href":"/api-reference/endpoint/get-contact-call-history"},{"title":"Find Call History by Phone Number","href":"/api-reference/endpoint/get-contact-call-history-by-phone"},{"title":"Update Contact","api":"PATCH /v1/contacts/{contactId}","href":"/api-reference/endpoint/update-contact"},{"title":"Delete Contact","api":"DELETE /v1/contacts/{contactId}","href":"/api-reference/endpoint/delete-contact"},{"title":"Get Contact Comments","api":"GET /v1/contacts/{contactId}/comments","href":"/api-reference/endpoint/get-contact-comments"},{"title":"Create Contact Comment","api":"POST /v1/comments","href":"/api-reference/endpoint/create-comment"},{"title":"Get Contact Tags","api":"GET /v1/contacts/{contactId}/tags","href":"/api-reference/endpoint/get-contact-tags"},{"title":"Add Tag to Contact","api":"POST /v1/contacts/{contactId}/tags/{tagId}","href":"/api-reference/endpoint/add-contact-tag"},{"title":"Remove Tag from Contact","api":"DELETE /v1/contacts/{contactId}/tags/{tagId}","href":"/api-reference/endpoint/remove-contact-tag"}]},{"group":"Eventos","pages":[{"title":"Send Events","api":"POST /v1/events","href":"/api-reference/endpoint/send-events"},{"title":"Identify a Session","api":"POST /v1/identify","href":"/api-reference/endpoint/identify"}]},{"group":"Etiquetas","pages":[{"title":"List Tags","api":"GET /v1/tags","href":"/api-reference/endpoint/list-tags"},{"title":"Create Tag","api":"POST /v1/tags","href":"/api-reference/endpoint/create-tag"},{"title":"Update Tag","api":"PATCH /v1/tags/{tagId}","href":"/api-reference/endpoint/update-tag"},{"title":"Delete Tag","api":"DELETE /v1/tags/{tagId}","href":"/api-reference/endpoint/delete-tag"}]},{"group":"Llamadas","pages":[{"title":"List Calls","api":"GET /v1/calls","href":"/api-reference/endpoint/list-calls"},{"title":"Get Call","api":"GET /v1/calls/{callId}","href":"/api-reference/endpoint/get-call"},{"title":"Get Call Status","api":"GET /v1/calls/{callId}/status","href":"/api-reference/endpoint/get-call-status"},{"title":"Stop Call","api":"POST /v1/calls/single-phone-call/{callId}/stop","href":"/api-reference/endpoint/stop-call"}]},{"group":"Tareas","pages":[{"title":"List Tasks","api":"GET /v1/tasks","href":"/api-reference/endpoint/list-tasks"},{"title":"Get Task","api":"GET /v1/tasks/{id}","href":"/api-reference/endpoint/get-task"},{"title":"Create Task","api":"POST /v1/tasks","href":"/api-reference/endpoint/create-task"}]},{"group":"Números de teléfono","pages":[{"title":"List Phone Numbers","api":"GET /v1/phone-numbers","href":"/api-reference/endpoint/get-phone-numbers"}]}]}]},{"language":"en","tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/en/get-started/what-is-contactship"}]},{"tab":"Use cases","pages":[{"title":"Use cases","href":"/en/use-cases"}]},{"tab":"API Reference","groups":[{"group":"API documentation","pages":[{"title":"API Introduction","href":"/api-reference/introduction"},{"title":"Rate Limits and Retries","href":"/api-reference/rate-limits"},{"title":"Call webhook payload","href":"/api-reference/webhooks"},{"title":"Inbound context webhook","href":"/api-reference/inbound-webhook"},{"title":"Follow-up closure webhook","href":"/api-reference/follow-up-webhook"},{"title":"HTTP tool execution","href":"/api-reference/tool-execution"}]},{"group":"Voice","pages":[{"title":"Make AI Phone Call","api":"POST /v1/calls/single-phone-call","description":"Initiate an outbound AI phone call using raw phone numbers","href":"/api-reference/endpoint/make-ai-phone-call"},{"title":"Call a Contact","api":"POST /v1/calls/single-contact-call","href":"/api-reference/endpoint/make-contact-call"}]},{"group":"WhatsApp (WABA)","pages":[{"title":"Send WhatsApp Message","api":"POST /v1/waba/send","description":"Send a text message to a contact via WhatsApp Business API (WABA)","href":"/api-reference/endpoint/waba-send-message"},{"title":"Send WhatsApp Template","api":"POST /v1/waba/send-template","href":"/api-reference/endpoint/waba-send-template"},{"title":"Send WhatsApp Media","api":"POST /v1/waba/send-media","href":"/api-reference/endpoint/waba-send-media"},{"title":"Send WhatsApp Location","api":"POST /v1/waba/send-location","href":"/api-reference/endpoint/waba-send-location"},{"title":"Get WhatsApp Templates","api":"GET /v1/waba/templates","href":"/api-reference/endpoint/waba-get-templates"}]},{"group":"Channels and threads","pages":[{"title":"List Channels","api":"GET /v1/channels","href":"/api-reference/endpoint/get-channels"},{"title":"List Conversations","api":"GET /v1/conversations","href":"/api-reference/endpoint/list-conversations"},{"title":"Get Thread","api":"GET /v1/thread/{threadId}","href":"/api-reference/endpoint/get-thread"},{"title":"List Thread Messages","api":"GET /v1/thread/{threadId}/messages","href":"/api-reference/endpoint/get-thread-messages"},{"title":"Update Thread","api":"PUT /v1/thread/{threadId}","href":"/api-reference/endpoint/update-thread"},{"title":"Get Message","api":"GET /v1/messages/{messageId}","href":"/api-reference/endpoint/get-message"}]},{"group":"Organization","pages":[{"title":"Get Credits","api":"GET /v1/credits","href":"/api-reference/endpoint/get-credits"}]},{"group":"Agents","pages":[{"title":"Create Agent","api":"POST /v1/agents","href":"/api-reference/endpoint/create-agent"},{"title":"Get Agent","api":"GET /v1/agents/{agentId}","href":"/api-reference/endpoint/get-agent"},{"title":"List Agents","api":"GET /v1/agents","href":"/api-reference/endpoint/list-agents"},{"title":"Update Agent","api":"PUT /v1/agents/{agentId}","href":"/api-reference/endpoint/update-agent"},{"title":"Delete Agent","api":"DELETE /v1/agents/{agentId}","href":"/api-reference/endpoint/delete-agent"},{"title":"List Voices","api":"GET /v1/agents/voices","href":"/api-reference/endpoint/list-voices"}]},{"group":"Contacts","pages":[{"title":"Get Contacts","api":"GET /v1/contacts","href":"/api-reference/endpoint/get-contacts"},{"title":"Create Contact","api":"POST /v1/contacts","href":"/api-reference/endpoint/create-contact"},{"title":"Get Contact by Identifier","api":"GET /v1/contacts/{identifier}","href":"/api-reference/endpoint/get-contact-by-identifier"},{"title":"Get Contact Call History","api":"GET /v1/contacts/{contactId}/call-history","href":"/api-reference/endpoint/get-contact-call-history"},{"title":"Find Call History by Phone Number","href":"/api-reference/endpoint/get-contact-call-history-by-phone"},{"title":"Update Contact","api":"PATCH /v1/contacts/{contactId}","href":"/api-reference/endpoint/update-contact"},{"title":"Delete Contact","api":"DELETE /v1/contacts/{contactId}","href":"/api-reference/endpoint/delete-contact"},{"title":"Get Contact Comments","api":"GET /v1/contacts/{contactId}/comments","href":"/api-reference/endpoint/get-contact-comments"},{"title":"Create Contact Comment","api":"POST /v1/comments","href":"/api-reference/endpoint/create-comment"},{"title":"Get Contact Tags","api":"GET /v1/contacts/{contactId}/tags","href":"/api-reference/endpoint/get-contact-tags"},{"title":"Add Tag to Contact","api":"POST /v1/contacts/{contactId}/tags/{tagId}","href":"/api-reference/endpoint/add-contact-tag"},{"title":"Remove Tag from Contact","api":"DELETE /v1/contacts/{contactId}/tags/{tagId}","href":"/api-reference/endpoint/remove-contact-tag"}]},{"group":"Events","pages":[{"title":"Send Events","api":"POST /v1/events","href":"/api-reference/endpoint/send-events"},{"title":"Identify a Session","api":"POST /v1/identify","href":"/api-reference/endpoint/identify"}]},{"group":"Tags","pages":[{"title":"List Tags","api":"GET /v1/tags","href":"/api-reference/endpoint/list-tags"},{"title":"Create Tag","api":"POST /v1/tags","href":"/api-reference/endpoint/create-tag"},{"title":"Update Tag","api":"PATCH /v1/tags/{tagId}","href":"/api-reference/endpoint/update-tag"},{"title":"Delete Tag","api":"DELETE /v1/tags/{tagId}","href":"/api-reference/endpoint/delete-tag"}]},{"group":"Calls","pages":[{"title":"List Calls","api":"GET /v1/calls","href":"/api-reference/endpoint/list-calls"},{"title":"Get Call","api":"GET /v1/calls/{callId}","href":"/api-reference/endpoint/get-call"},{"title":"Get Call Status","api":"GET /v1/calls/{callId}/status","href":"/api-reference/endpoint/get-call-status"},{"title":"Stop Call","api":"POST /v1/calls/single-phone-call/{callId}/stop","href":"/api-reference/endpoint/stop-call"}]},{"group":"Tasks","pages":[{"title":"List Tasks","api":"GET /v1/tasks","href":"/api-reference/endpoint/list-tasks"},{"title":"Get Task","api":"GET /v1/tasks/{id}","href":"/api-reference/endpoint/get-task"},{"title":"Create Task","api":"POST /v1/tasks","href":"/api-reference/endpoint/create-task"}]},{"group":"Phone numbers","pages":[{"title":"List Phone Numbers","api":"GET /v1/phone-numbers","href":"/api-reference/endpoint/get-phone-numbers"}]}]}]}]},"basePath":"","title":"Call a Contact - ContactShip Docs","deploymentId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","buildId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","dynamics":["c2aa737661","2b790eda92","b0f84f53ff"],"chunks":["OpenApiReferenceProvider-B6WFFOBL.js","utils-BN5um1KA.js","cloneDeep-C3md22mN.js","_Uint8Array-DLlL8L26.js","isObject-FP1Yky1u.js","utils-BSmbkXJR.js","addUniqueKeysToSchema-2tqcVnUE.js","snippetPresets-CtWfvr2J.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-DkKHBy30.js","isEqual-O3q7y6pq.js","usePlaygroundInputsStore-Brc5H9UJ.js","shallow-C4L4xvbs.js","getApiPlaygroundDisplay-2bxyq_aI.js","CodeSnippet-BJu8ddd5.js","CodeSnippets-dazWmoqB.js","Page-CnLhKuUV.js","getPastedJson-Chy3Qa1S.js","icon-CyO7h3jh.js","MethodPill-Dle0_91v.js","DuplicateIcon-CVvWAf4a.js","createIcon-Di07A27B.js","DynamicMarkdown-C4w9kavL.js","SectionHeading-XiBebVYC.js","axios-vUo_bRtp.js"]}