Schedules an outbound call and returns the new task with 201 Created.
Calls are scheduled at or after requested_at, within the agent’s calling hours. If no call fits before expires_at, creating a task returns 400 Bad Request. Outbound calling must be enabled for the agent or the request returns 403 Forbidden.
An existing task is returned with 200 OK in either case:
The same ext_id is submitted while its task is still active.
Allow re-enrollment is off and the same contact already has a task with this agent. This includes completed, canceled, and failed tasks, even when the new request uses a different ext_id.
Allow re-enrollment is on by default. To change it, update the agent’s outbound calling settings and publish. Returning an existing task does not restart outreach.
The earliest time the call may be placed. Accepts ISO 8601 format with a timezone offset (e.g. '2026-08-03T14:30:00Z' or '2026-08-03T09:30:00-05:00'). A time in the past means as soon as the agent's calling hours allow. May be at most 90 days in the future.
The time past which the call is no longer worth placing, for example because the appointment it is about has happened. If no call can be placed before it, the task fails instead of calling late. Defaults to five days after requested_at, and must be after it.
Custom fields to set on the customer interaction created for this call. Each key must match the field_name of a Customer interaction custom field defined in your Alpharun dashboard; entries whose keys don't match a definition are ignored.
Your identifier for the call task, such as an appointment ID. Reusing it returns the existing task while it is active. After the task ends, the ID can be reused if the agent allows re-enrollment.
Maximum string length: 255
Response
An existing task was returned; no new task was created.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Alpharun","colors":{"primary":"#1f3faf","light":"#005dcd","dark":"#1f3faf"},"logo":{"light":"https://mintcdn.com/alpharun/8IhX2s1kQ_8UHzDC/logo/light.svg?fit=max\u0026auto=format\u0026n=8IhX2s1kQ_8UHzDC\u0026q=85\u0026s=fdd2c7ebad8770f9efae37de8c31b2cc","dark":"https://mintcdn.com/alpharun/8IhX2s1kQ_8UHzDC/logo/dark.svg?fit=max\u0026auto=format\u0026n=8IhX2s1kQ_8UHzDC\u0026q=85\u0026s=929101062402c042dd6125893863a18c"},"favicon":{"light":"https://mintcdn.com/alpharun/8IhX2s1kQ_8UHzDC/favicon_light.png?fit=max\u0026auto=format\u0026n=8IhX2s1kQ_8UHzDC\u0026q=85\u0026s=3f4b3716882d87016d3d594dd4cc69e9","dark":"https://mintcdn.com/alpharun/8IhX2s1kQ_8UHzDC/favicon_dark.png?fit=max\u0026auto=format\u0026n=8IhX2s1kQ_8UHzDC\u0026q=85\u0026s=d7bb455e7c5824ca1f3dc78e2cb1b41f"},"navbar":{"links":[{"href":"mailto:[email protected]","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.alpharun.com"}},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/alpharunhq"}},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Help center","icon":"book-open-cover","href":"https://help.alpharun.com"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"alpharun","hasAudioNarration":false,"actualSubdomain":"alpharun","customDomains":["dev.alpharun.com"],"gitSource":{"type":"github","owner":"alpharunhq","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6adb7d2f2022e06ed320da50","clientVersion":"0.0.4087","searchFilterCounts":[{"language":"default","tag":"API Reference","count":42},{"language":"default","tag":"Hiring","count":13},{"language":"default","tag":"Call monitoring","count":12},{"language":"default","tag":"Outbound calling","count":6},{"language":"default","tag":"Contacts","count":5},{"language":"default","tag":"Teammates","count":5},{"language":"default","tag":"Documentation","count":2},{"language":"default","tag":"Get Started","count":2},{"language":"default","tag":"API Documentation","count":1}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/endpoint/create-call-task","slug":"/api-reference/endpoint/create-call-task","pageMetadata":{"title":"Create Call Task","openapi":"POST /call-tasks","description":"Schedules an outbound call and returns the new task with **`201 Created`**.\n\nCalls are scheduled at or after `requested_at`, within the agent's calling hours. If no call fits before `expires_at`, creating a task returns **`400 Bad Request`**. Outbound calling must be enabled for the agent or the request returns **`403 Forbidden`**.\n\nAn existing task is returned with **`200 OK`** in either case:\n\n- The same `ext_id` is submitted while its task is still active.\n- **Allow re-enrollment** is off and the same contact already has a task with this agent. This includes completed, canceled, and failed tasks, even when the new request uses a different `ext_id`.\n\n**Allow re-enrollment** is on by default. To change it, update the agent's outbound calling settings and publish. Returning an existing task does not restart outreach.","href":"/api-reference/endpoint/create-call-task"},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n li: \"li\",\n p: \"p\",\n strong: \"strong\",\n ul: \"ul\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [\"Schedules an outbound call and returns the new task with \", _jsx(_components.strong, {\n children: _jsx(_components.code, {\n children: \"201 Created\"\n })\n }), \".\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Calls are scheduled at or after \", _jsx(_components.code, {\n children: \"requested_at\"\n }), \", within the agent’s calling hours. If no call fits before \", _jsx(_components.code, {\n children: \"expires_at\"\n }), \", creating a task returns \", _jsx(_components.strong, {\n children: _jsx(_components.code, {\n children: \"400 Bad Request\"\n })\n }), \". Outbound calling must be enabled for the agent or the request returns \", _jsx(_components.strong, {\n children: _jsx(_components.code, {\n children: \"403 Forbidden\"\n })\n }), \".\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"An existing task is returned with \", _jsx(_components.strong, {\n children: _jsx(_components.code, {\n children: \"200 OK\"\n })\n }), \" in either case:\"]\n }), \"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsxs(_components.li, {\n children: [\"The same \", _jsx(_components.code, {\n children: \"ext_id\"\n }), \" is submitted while its task is still active.\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.strong, {\n children: \"Allow re-enrollment\"\n }), \" is off and the same contact already has a task with this agent. This includes completed, canceled, and failed tasks, even when the new request uses a different \", _jsx(_components.code, {\n children: \"ext_id\"\n }), \".\"]\n }), \"\\n\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Allow re-enrollment\"\n }), \" is on by default. To change it, update the agent’s outbound calling settings and publish. Returning an existing task does not restart outreach.\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Create Call Task","openapi":"POST /call-tasks","description":"Schedules an outbound call and returns the new task with **`201 Created`**.\n\nCalls are scheduled at or after `requested_at`, within the agent's calling hours. If no call fits before `expires_at`, creating a task returns **`400 Bad Request`**. Outbound calling must be enabled for the agent or the request returns **`403 Forbidden`**.\n\nAn existing task is returned with **`200 OK`** in either case:\n\n- The same `ext_id` is submitted while its task is still active.\n- **Allow re-enrollment** is off and the same contact already has a task with this agent. This includes completed, canceled, and failed tasks, even when the new request uses a different `ext_id`.\n\n**Allow re-enrollment** is on by default. To change it, update the agent's outbound calling settings and publish. Returning an existing task does not restart outreach.","href":"/api-reference/endpoint/create-call-task"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"description":"Schedules an outbound call and returns the new task with **`201 Created`**.\n\nCalls are scheduled at or after `requested_at`, within the agent's calling hours. If no call fits before `expires_at`, creating a task returns **`400 Bad Request`**. Outbound calling must be enabled for the agent or the request returns **`403 Forbidden`**.\n\nAn existing task is returned with **`200 OK`** in either case:\n\n- The same `ext_id` is submitted while its task is still active.\n- **Allow re-enrollment** is off and the same contact already has a task with this agent. This includes completed, canceled, and failed tasks, even when the new request uses a different `ext_id`.\n\n**Allow re-enrollment** is on by default. To change it, update the agent's outbound calling settings and publish. Returning an existing task does not restart outreach.","requestBody":"2b19e4e7-a5ba-47b9-812f-f58dfbbec936","responses":{"200":"c79f4e66-2138-4f5c-83a5-ff549b8df815","201":"21aa251c-6876-44ca-8f3c-194b45470013","400":"7b991166-5764-44ec-9c3c-50e71db1ae6c","403":"45753b57-0a80-4018-90c5-f14ca5d3e877","404":"4b98c04b-6037-4012-b33f-f4411f6af5ae"},"method":"post","type":"path","servers":["bd64585e-97e9-4571-a845-c6fa4e5052da"],"security":["e97053cf-46f1-4b5f-a7ae-9d451bfcbfa7"],"path":"/call-tasks","baseUrlOptions":["https://api.alpharun.com/api/v1"],"title":"","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["agent_id","requested_at","contact"],"properties":{"agent_id":{"type":"string","format":"uuid","description":"The UUID of the voice agent that will place the call.","isRequired":true,"uniqueKey":"agent_id","typeLabel":"string\u003cuuid>"},"requested_at":{"type":"string","format":"date-time","description":"The earliest time the call may be placed. Accepts ISO 8601 format with a timezone offset (e.g. '2026-08-03T14:30:00Z' or '2026-08-03T09:30:00-05:00'). A time in the past means as soon as the agent's calling hours allow. May be at most 90 days in the future.","isRequired":true,"uniqueKey":"requested_at","typeLabel":"string\u003cdate-time>"},"contact":{"type":"object","required":["phone_number"],"description":"The contact to call. Alpharun uses the external ID, phone number, or email to find or create the contact. A phone number is required.","properties":{"phone_number":{"oneOf":[{"type":"string","description":"Phone number to call, in E.164 format (e.g. `+14155550123`)","isRequired":true,"uniqueKey":"contact.phone_number.oneOf.0","typeLabel":"string"},{"type":"number","description":"Phone number to call, in E.164 format (e.g. `+14155550123`)","isRequired":true,"uniqueKey":"contact.phone_number.oneOf.1","typeLabel":"number"}],"isRequired":true,"uniqueKey":"contact.phone_number","typeLabel":"string | number"},"email":{"type":"string","format":"email","description":"Email address of the contact","uniqueKey":"contact.email","typeLabel":"string\u003cemail>"},"first_name":{"type":"string","description":"First name of the contact","uniqueKey":"contact.first_name","typeLabel":"string"},"last_name":{"type":"string","description":"Last name of the contact","uniqueKey":"contact.last_name","typeLabel":"string"},"ext_id":{"type":"string","description":"Your identifier for the contact. Reuse it for the same contact. Different values identify separate contacts, even when the phone number matches.","uniqueKey":"contact.ext_id","typeLabel":"string"},"custom_fields":{"type":"array","description":"Custom fields associated with the contact","items":{"type":"object","required":["key","value"],"properties":{"key":{"type":"string","isRequired":true,"uniqueKey":"contact.custom_fields.items.[INDEX].key","typeLabel":"string"},"value":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"contact.custom_fields.items.[INDEX].value.oneOf.0","typeLabel":"string"},{"type":"number","isRequired":true,"uniqueKey":"contact.custom_fields.items.[INDEX].value.oneOf.1","typeLabel":"number"},{"type":"boolean","isRequired":true,"uniqueKey":"contact.custom_fields.items.[INDEX].value.oneOf.2","typeLabel":"boolean"},{"type":"null","isRequired":true,"uniqueKey":"contact.custom_fields.items.[INDEX].value.oneOf.3","typeLabel":"null"}],"isRequired":true,"uniqueKey":"contact.custom_fields.items.[INDEX].value","typeLabel":"string | number | boolean | null"}},"uniqueKey":"contact.custom_fields.items.[INDEX]","typeLabel":"object"},"uniqueKey":"contact.custom_fields","typeLabel":"object[]"}},"isRequired":true,"uniqueKey":"contact","typeLabel":"object"},"expires_at":{"type":"string","format":"date-time","description":"The time past which the call is no longer worth placing, for example because the appointment it is about has happened. If no call can be placed before it, the task fails instead of calling late. Defaults to five days after `requested_at`, and must be after it.","uniqueKey":"expires_at","typeLabel":"string\u003cdate-time>"},"custom_fields":{"type":"array","description":"Custom fields to set on the customer interaction created for this call. Each `key` must match the `field_name` of a **Customer interaction** custom field defined in your Alpharun dashboard; entries whose keys don't match a definition are ignored.","items":{"type":"object","required":["key","value"],"properties":{"key":{"type":"string","description":"The `field_name` of the customer interaction custom field to set.","isRequired":true,"uniqueKey":"custom_fields.items.[INDEX].key","typeLabel":"string"},"value":{"oneOf":[{"type":"string","description":"Value to set for the custom field.","isRequired":true,"uniqueKey":"custom_fields.items.[INDEX].value.oneOf.0","typeLabel":"string"},{"type":"number","description":"Value to set for the custom field.","isRequired":true,"uniqueKey":"custom_fields.items.[INDEX].value.oneOf.1","typeLabel":"number"},{"type":"boolean","description":"Value to set for the custom field.","isRequired":true,"uniqueKey":"custom_fields.items.[INDEX].value.oneOf.2","typeLabel":"boolean"},{"type":"null","isRequired":true,"uniqueKey":"custom_fields.items.[INDEX].value.oneOf.3","typeLabel":"null"}],"isRequired":true,"uniqueKey":"custom_fields.items.[INDEX].value","typeLabel":"string | number | boolean | null"}},"uniqueKey":"custom_fields.items.[INDEX]","typeLabel":"object"},"uniqueKey":"custom_fields","typeLabel":"object[]"},"ext_id":{"type":"string","maxLength":255,"description":"Your identifier for the call task, such as an appointment ID. Reusing it returns the existing task while it is active. After the task ends, the ID can be reused if the agent allows re-enrollment.","uniqueKey":"ext_id","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"agent_id":"660e8400-e29b-41d4-a716-446655440001","requested_at":"2026-08-03T10:00:00.000Z","ext_id":"appointment-1234","contact":{"phone_number":"+14155550123","first_name":"Casey","last_name":"Doe"},"custom_fields":[{"key":"advisor","value":"Dana"}]},"examples":{"Example":{"title":"Example","value":{"agent_id":"660e8400-e29b-41d4-a716-446655440001","requested_at":"2026-08-03T10:00:00.000Z","ext_id":"appointment-1234","contact":{"phone_number":"+14155550123","first_name":"Casey","last_name":"Doe"},"custom_fields":[{"key":"advisor","value":"Dana"}]}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"c79f4e66-2138-4f5c-83a5-ff549b8df815":{"description":"An existing task was returned; no new task was created.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"call_task":{"type":"object","required":["id","ext_id","agent_id","contact_id","status","requested_at","scheduled_at","expires_at","created_at","completed_at","canceled_at","cancel_requested_at","attempts"],"description":"An outbound call you asked a voice agent to place, with one entry in `attempts` for each attempt at reaching the contact.","properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier of the call task","isRequired":true,"uniqueKey":"data.call_task.id","typeLabel":"string\u003cuuid>"},"ext_id":{"oneOf":[{"type":"string","description":"Your own identifier for the call task, or `null` if you did not provide one","isRequired":true,"uniqueKey":"data.call_task.ext_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"Your own identifier for the call task, or `null` if you did not provide one","isRequired":true,"uniqueKey":"data.call_task.ext_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.call_task.ext_id","typeLabel":"string | null"},"agent_id":{"type":"string","format":"uuid","description":"ID of the voice agent placing the call","isRequired":true,"uniqueKey":"data.call_task.agent_id","typeLabel":"string\u003cuuid>"},"contact_id":{"type":"string","format":"uuid","description":"ID of the contact being called","isRequired":true,"uniqueKey":"data.call_task.contact_id","typeLabel":"string\u003cuuid>"},"status":{"type":"string","enum":["scheduled","calling","processing","completed","canceled","failed"],"description":"Status of the call task: `scheduled` when it is waiting to be called (including while it waits to be retried), `calling` while a call is being placed, `processing` once a call has ended and is being analyzed, and `completed`, `canceled` and `failed` once it is done. A `failed` task will not be called again; the reason is on its last attempt.","isRequired":true,"uniqueKey":"data.call_task.status","typeLabel":"enum\u003cstring>"},"requested_at":{"type":"string","format":"date-time","description":"The earliest time the call may be placed, as you requested it","isRequired":true,"uniqueKey":"data.call_task.requested_at","typeLabel":"string\u003cdate-time>"},"scheduled_at":{"type":"string","format":"date-time","description":"The time the call is currently scheduled for: the first moment at or after `requested_at` that falls within the agent's calling hours. It moves when the task is rescheduled or is due to be retried.","isRequired":true,"uniqueKey":"data.call_task.scheduled_at","typeLabel":"string\u003cdate-time>"},"expires_at":{"type":"string","format":"date-time","description":"The time past which the call is no longer placed","isRequired":true,"uniqueKey":"data.call_task.expires_at","typeLabel":"string\u003cdate-time>"},"created_at":{"type":"string","format":"date-time","description":"When the call task was created","isRequired":true,"uniqueKey":"data.call_task.created_at","typeLabel":"string\u003cdate-time>"},"completed_at":{"oneOf":[{"type":"string","format":"date-time","description":"When the call task completed, or `null` if it has not","isRequired":true,"uniqueKey":"data.call_task.completed_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"When the call task completed, or `null` if it has not","isRequired":true,"uniqueKey":"data.call_task.completed_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.call_task.completed_at","typeLabel":"string\u003cdate-time> | null"},"canceled_at":{"oneOf":[{"type":"string","format":"date-time","description":"When the call task was canceled, or `null` if it was not","isRequired":true,"uniqueKey":"data.call_task.canceled_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"When the call task was canceled, or `null` if it was not","isRequired":true,"uniqueKey":"data.call_task.canceled_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.call_task.canceled_at","typeLabel":"string\u003cdate-time> | null"},"cancel_requested_at":{"oneOf":[{"type":"string","format":"date-time","description":"When a cancellation was requested while a call was already under way, or `null`","isRequired":true,"uniqueKey":"data.call_task.cancel_requested_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"When a cancellation was requested while a call was already under way, or `null`","isRequired":true,"uniqueKey":"data.call_task.cancel_requested_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.call_task.cancel_requested_at","typeLabel":"string\u003cdate-time> | null"},"attempts":{"type":"array","description":"One entry per attempt at reaching the contact, oldest first","items":{"type":"object","required":["attempt_number","started_at","result","error"],"description":"One attempt at reaching the contact: when it started, how it ended, and why. Attempts where no call was placed at all — for example because the contact has no phone number — are included, with a `not_dialed` result.","properties":{"attempt_number":{"type":"integer","description":"Position of this attempt in the task's attempts, starting at 1","isRequired":true,"uniqueKey":"data.call_task.attempts.items.[INDEX].attempt_number","typeLabel":"integer"},"started_at":{"type":"string","format":"date-time","description":"When the attempt started","isRequired":true,"uniqueKey":"data.call_task.attempts.items.[INDEX].started_at","typeLabel":"string\u003cdate-time>"},"result":{"oneOf":[{"type":"string","enum":["contacted","no_contact","unknown","no_answer","busy","failed","not_dialed"],"description":"How the attempt ended, or `null` while it is still in progress. The call connected on `contacted` (a person was on the line), `no_contact` (nobody engaged, for example voicemail) and `unknown` (what came of it was never established). The call never connected on `no_answer` (the phone rang out), `busy` and `failed` (the call could not be completed). On `not_dialed` no call was placed at all, and `error` says what stopped it.","isRequired":true,"uniqueKey":"data.call_task.attempts.items.[INDEX].result.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["contacted","no_contact","unknown","no_answer","busy","failed","not_dialed"],"description":"How the attempt ended, or `null` while it is still in progress. The call connected on `contacted` (a person was on the line), `no_contact` (nobody engaged, for example voicemail) and `unknown` (what came of it was never established). The call never connected on `no_answer` (the phone rang out), `busy` and `failed` (the call could not be completed). On `not_dialed` no call was placed at all, and `error` says what stopped it.","isRequired":true,"uniqueKey":"data.call_task.attempts.items.[INDEX].result.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.call_task.attempts.items.[INDEX].result","typeLabel":"enum\u003cstring> | null"},"error":{"oneOf":[{"type":"object","required":["code","message"],"description":"Why the attempt produced no conversation, or `null` when there is nothing to report","properties":{"code":{"type":"string","enum":["feature_disabled","agent_calling_disabled","no_phone_number","agent_number_missing","agent_unavailable","no_calling_window","dial_failed","call_setup_failed","workflow_lost","retries_exhausted","expired","window_past_expiry"],"description":"Stable code to group errors by. Nothing was set up to call with on `feature_disabled`, `agent_calling_disabled`, `no_phone_number`, `agent_number_missing`, `agent_unavailable` and `no_calling_window`; the call was placed but did not work out on `dial_failed`, `call_setup_failed` and `workflow_lost`; and the task ran out of retries or time on `retries_exhausted`, `expired` and `window_past_expiry`.","isRequired":true,"uniqueKey":"data.call_task.attempts.items.[INDEX].error.oneOf.0.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable detail about what went wrong","isRequired":true,"uniqueKey":"data.call_task.attempts.items.[INDEX].error.oneOf.0.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"data.call_task.attempts.items.[INDEX].error.oneOf.0","typeLabel":"object"},{"type":"null","required":["code","message"],"description":"Why the attempt produced no conversation, or `null` when there is nothing to report","properties":{"code":{"type":"string","enum":["feature_disabled","agent_calling_disabled","no_phone_number","agent_number_missing","agent_unavailable","no_calling_window","dial_failed","call_setup_failed","workflow_lost","retries_exhausted","expired","window_past_expiry"],"description":"Stable code to group errors by. Nothing was set up to call with on `feature_disabled`, `agent_calling_disabled`, `no_phone_number`, `agent_number_missing`, `agent_unavailable` and `no_calling_window`; the call was placed but did not work out on `dial_failed`, `call_setup_failed` and `workflow_lost`; and the task ran out of retries or time on `retries_exhausted`, `expired` and `window_past_expiry`."},"message":{"type":"string","description":"Human-readable detail about what went wrong"}},"isRequired":true,"uniqueKey":"data.call_task.attempts.items.[INDEX].error.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.call_task.attempts.items.[INDEX].error","typeLabel":"object | null"}},"uniqueKey":"data.call_task.attempts.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.call_task.attempts","typeLabel":"object[]"}},"uniqueKey":"data.call_task","typeLabel":"object"}},"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"data":{"call_task":{"id":"550e8400-e29b-41d4-a716-446655440000","ext_id":"appointment-1234","agent_id":"660e8400-e29b-41d4-a716-446655440001","contact_id":"770e8400-e29b-41d4-a716-446655440002","status":"scheduled","requested_at":"2026-08-03T10:00:00.000Z","scheduled_at":"2026-08-03T13:00:00.000Z","expires_at":"2026-08-08T10:00:00.000Z","created_at":"2026-08-01T09:12:44.000Z","completed_at":null,"canceled_at":null,"cancel_requested_at":null,"attempts":[]}}},"examples":{"Example":{"title":"Example","value":{"data":{"call_task":{"id":"550e8400-e29b-41d4-a716-446655440000","ext_id":"appointment-1234","agent_id":"660e8400-e29b-41d4-a716-446655440001","contact_id":"770e8400-e29b-41d4-a716-446655440002","status":"scheduled","requested_at":"2026-08-03T10:00:00.000Z","scheduled_at":"2026-08-03T13:00:00.000Z","expires_at":"2026-08-08T10:00:00.000Z","created_at":"2026-08-01T09:12:44.000Z","completed_at":null,"canceled_at":null,"cancel_requested_at":null,"attempts":[]}}}}},"exampleType":"examples"}},"exampleType":"examples"},"21aa251c-6876-44ca-8f3c-194b45470013":{"description":"Call task scheduled","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"call_task":{"type":"object","required":["id","ext_id","agent_id","contact_id","status","requested_at","scheduled_at","expires_at","created_at","completed_at","canceled_at","cancel_requested_at","attempts"],"description":"An outbound call you asked a voice agent to place, with one entry in `attempts` for each attempt at reaching the contact.","properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier of the call task","isRequired":true,"uniqueKey":"data.call_task.id","typeLabel":"string\u003cuuid>"},"ext_id":{"oneOf":[{"type":"string","description":"Your own identifier for the call task, or `null` if you did not provide one","isRequired":true,"uniqueKey":"data.call_task.ext_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"Your own identifier for the call task, or `null` if you did not provide one","isRequired":true,"uniqueKey":"data.call_task.ext_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.call_task.ext_id","typeLabel":"string | null"},"agent_id":{"type":"string","format":"uuid","description":"ID of the voice agent placing the call","isRequired":true,"uniqueKey":"data.call_task.agent_id","typeLabel":"string\u003cuuid>"},"contact_id":{"type":"string","format":"uuid","description":"ID of the contact being called","isRequired":true,"uniqueKey":"data.call_task.contact_id","typeLabel":"string\u003cuuid>"},"status":{"type":"string","enum":["scheduled","calling","processing","completed","canceled","failed"],"description":"Status of the call task: `scheduled` when it is waiting to be called (including while it waits to be retried), `calling` while a call is being placed, `processing` once a call has ended and is being analyzed, and `completed`, `canceled` and `failed` once it is done. A `failed` task will not be called again; the reason is on its last attempt.","isRequired":true,"uniqueKey":"data.call_task.status","typeLabel":"enum\u003cstring>"},"requested_at":{"type":"string","format":"date-time","description":"The earliest time the call may be placed, as you requested it","isRequired":true,"uniqueKey":"data.call_task.requested_at","typeLabel":"string\u003cdate-time>"},"scheduled_at":{"type":"string","format":"date-time","description":"The time the call is currently scheduled for: the first moment at or after `requested_at` that falls within the agent's calling hours. It moves when the task is rescheduled or is due to be retried.","isRequired":true,"uniqueKey":"data.call_task.scheduled_at","typeLabel":"string\u003cdate-time>"},"expires_at":{"type":"string","format":"date-time","description":"The time past which the call is no longer placed","isRequired":true,"uniqueKey":"data.call_task.expires_at","typeLabel":"string\u003cdate-time>"},"created_at":{"type":"string","format":"date-time","description":"When the call task was created","isRequired":true,"uniqueKey":"data.call_task.created_at","typeLabel":"string\u003cdate-time>"},"completed_at":{"oneOf":[{"type":"string","format":"date-time","description":"When the call task completed, or `null` if it has not","isRequired":true,"uniqueKey":"data.call_task.completed_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"When the call task completed, or `null` if it has not","isRequired":true,"uniqueKey":"data.call_task.completed_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.call_task.completed_at","typeLabel":"string\u003cdate-time> | null"},"canceled_at":{"oneOf":[{"type":"string","format":"date-time","description":"When the call task was canceled, or `null` if it was not","isRequired":true,"uniqueKey":"data.call_task.canceled_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"When the call task was canceled, or `null` if it was not","isRequired":true,"uniqueKey":"data.call_task.canceled_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.call_task.canceled_at","typeLabel":"string\u003cdate-time> | null"},"cancel_requested_at":{"oneOf":[{"type":"string","format":"date-time","description":"When a cancellation was requested while a call was already under way, or `null`","isRequired":true,"uniqueKey":"data.call_task.cancel_requested_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"When a cancellation was requested while a call was already under way, or `null`","isRequired":true,"uniqueKey":"data.call_task.cancel_requested_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.call_task.cancel_requested_at","typeLabel":"string\u003cdate-time> | null"},"attempts":{"type":"array","description":"One entry per attempt at reaching the contact, oldest first","items":{"type":"object","required":["attempt_number","started_at","result","error"],"description":"One attempt at reaching the contact: when it started, how it ended, and why. Attempts where no call was placed at all — for example because the contact has no phone number — are included, with a `not_dialed` result.","properties":{"attempt_number":{"type":"integer","description":"Position of this attempt in the task's attempts, starting at 1","isRequired":true,"uniqueKey":"data.call_task.attempts.items.[INDEX].attempt_number","typeLabel":"integer"},"started_at":{"type":"string","format":"date-time","description":"When the attempt started","isRequired":true,"uniqueKey":"data.call_task.attempts.items.[INDEX].started_at","typeLabel":"string\u003cdate-time>"},"result":{"oneOf":[{"type":"string","enum":["contacted","no_contact","unknown","no_answer","busy","failed","not_dialed"],"description":"How the attempt ended, or `null` while it is still in progress. The call connected on `contacted` (a person was on the line), `no_contact` (nobody engaged, for example voicemail) and `unknown` (what came of it was never established). The call never connected on `no_answer` (the phone rang out), `busy` and `failed` (the call could not be completed). On `not_dialed` no call was placed at all, and `error` says what stopped it.","isRequired":true,"uniqueKey":"data.call_task.attempts.items.[INDEX].result.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["contacted","no_contact","unknown","no_answer","busy","failed","not_dialed"],"description":"How the attempt ended, or `null` while it is still in progress. The call connected on `contacted` (a person was on the line), `no_contact` (nobody engaged, for example voicemail) and `unknown` (what came of it was never established). The call never connected on `no_answer` (the phone rang out), `busy` and `failed` (the call could not be completed). On `not_dialed` no call was placed at all, and `error` says what stopped it.","isRequired":true,"uniqueKey":"data.call_task.attempts.items.[INDEX].result.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.call_task.attempts.items.[INDEX].result","typeLabel":"enum\u003cstring> | null"},"error":{"oneOf":[{"type":"object","required":["code","message"],"description":"Why the attempt produced no conversation, or `null` when there is nothing to report","properties":{"code":{"type":"string","enum":["feature_disabled","agent_calling_disabled","no_phone_number","agent_number_missing","agent_unavailable","no_calling_window","dial_failed","call_setup_failed","workflow_lost","retries_exhausted","expired","window_past_expiry"],"description":"Stable code to group errors by. Nothing was set up to call with on `feature_disabled`, `agent_calling_disabled`, `no_phone_number`, `agent_number_missing`, `agent_unavailable` and `no_calling_window`; the call was placed but did not work out on `dial_failed`, `call_setup_failed` and `workflow_lost`; and the task ran out of retries or time on `retries_exhausted`, `expired` and `window_past_expiry`.","isRequired":true,"uniqueKey":"data.call_task.attempts.items.[INDEX].error.oneOf.0.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable detail about what went wrong","isRequired":true,"uniqueKey":"data.call_task.attempts.items.[INDEX].error.oneOf.0.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"data.call_task.attempts.items.[INDEX].error.oneOf.0","typeLabel":"object"},{"type":"null","required":["code","message"],"description":"Why the attempt produced no conversation, or `null` when there is nothing to report","properties":{"code":{"type":"string","enum":["feature_disabled","agent_calling_disabled","no_phone_number","agent_number_missing","agent_unavailable","no_calling_window","dial_failed","call_setup_failed","workflow_lost","retries_exhausted","expired","window_past_expiry"],"description":"Stable code to group errors by. Nothing was set up to call with on `feature_disabled`, `agent_calling_disabled`, `no_phone_number`, `agent_number_missing`, `agent_unavailable` and `no_calling_window`; the call was placed but did not work out on `dial_failed`, `call_setup_failed` and `workflow_lost`; and the task ran out of retries or time on `retries_exhausted`, `expired` and `window_past_expiry`."},"message":{"type":"string","description":"Human-readable detail about what went wrong"}},"isRequired":true,"uniqueKey":"data.call_task.attempts.items.[INDEX].error.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.call_task.attempts.items.[INDEX].error","typeLabel":"object | null"}},"uniqueKey":"data.call_task.attempts.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.call_task.attempts","typeLabel":"object[]"}},"uniqueKey":"data.call_task","typeLabel":"object"}},"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"data":{"call_task":{"id":"550e8400-e29b-41d4-a716-446655440000","ext_id":"appointment-1234","agent_id":"660e8400-e29b-41d4-a716-446655440001","contact_id":"770e8400-e29b-41d4-a716-446655440002","status":"scheduled","requested_at":"2026-08-03T10:00:00.000Z","scheduled_at":"2026-08-03T13:00:00.000Z","expires_at":"2026-08-08T10:00:00.000Z","created_at":"2026-08-01T09:12:44.000Z","completed_at":null,"canceled_at":null,"cancel_requested_at":null,"attempts":[]}}},"examples":{"Example":{"title":"Example","value":{"data":{"call_task":{"id":"550e8400-e29b-41d4-a716-446655440000","ext_id":"appointment-1234","agent_id":"660e8400-e29b-41d4-a716-446655440001","contact_id":"770e8400-e29b-41d4-a716-446655440002","status":"scheduled","requested_at":"2026-08-03T10:00:00.000Z","scheduled_at":"2026-08-03T13:00:00.000Z","expires_at":"2026-08-08T10:00:00.000Z","created_at":"2026-08-01T09:12:44.000Z","completed_at":null,"canceled_at":null,"cancel_requested_at":null,"attempts":[]}}}}},"exampleType":"examples"}},"exampleType":"examples"},"7b991166-5764-44ec-9c3c-50e71db1ae6c":{"description":"Invalid payload, or a new task cannot be scheduled before it expires","content":{"application/json":{"schema":{"required":["error","message"],"type":"object","properties":{"error":{"type":"integer","format":"int32","isRequired":true,"uniqueKey":"error","typeLabel":"integer\u003cint32>"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":123,"message":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"45753b57-0a80-4018-90c5-f14ca5d3e877":{"description":"Outbound calling is not enabled for the voice agent","content":{"application/json":{"schema":{"required":["error","message"],"type":"object","properties":{"error":{"type":"integer","format":"int32","isRequired":true,"uniqueKey":"error","typeLabel":"integer\u003cint32>"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":123,"message":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"4b98c04b-6037-4012-b33f-f4411f6af5ae":{"description":"Agent not found","content":{"application/json":{"schema":{"required":["error","message"],"type":"object","properties":{"error":{"type":"integer","format":"int32","isRequired":true,"uniqueKey":"error","typeLabel":"integer\u003cint32>"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":123,"message":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"e97053cf-46f1-4b5f-a7ae-9d451bfcbfa7":{"bearerAuth":{"type":"http","scheme":"bearer","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"bd64585e-97e9-4571-a845-c6fa4e5052da":{"url":"https://api.alpharun.com/api/v1"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"alpharun","siteName":"Alpharun","title":"Create Call Task - Alpharun","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-10T20:54:08.236Z","originalFileLocation":"api-reference/endpoint/create-call-task.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Schedules an outbound call and returns the new task with 201 Created. Calls are scheduled at or after requested_at, within the agent\u0026#x27;s calling hours. If no call fits before expires_at, creating a task returns 400 Bad Request. Outbound calling must be enabled for the agent or the request returns 403 Forbidden. An existing task is returned with 200 OK in either case: - The same ext_id is submitted while its task is still active. - Allow re-enrollment is off and the same contact already has a task with this agent. This includes completed, canceled, and failed tasks, even when the new request uses a different ext_id. Allow re-enrollment is on by default. To change it, update the agent\u0026#x27;s outbound calling settings and publish. Returning an existing task does not restart outreach.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Alpharun\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/alpharun/YgxLmOgl6_rcKn72/_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/alpharun/YgxLmOgl6_rcKn72/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/alpharun/YgxLmOgl6_rcKn72/_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/alpharun/YgxLmOgl6_rcKn72/_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/alpharun/YgxLmOgl6_rcKn72/_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/alpharun/YgxLmOgl6_rcKn72/_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/alpharun/YgxLmOgl6_rcKn72/_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/alpharun/YgxLmOgl6_rcKn72/_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/alpharun/YgxLmOgl6_rcKn72/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create Call Task - Alpharun\">\u003cmeta data-mint-head property=\"og:description\" content=\"Schedules an outbound call and returns the new task with 201 Created. Calls are scheduled at or after requested_at, within the agent\u0026#x27;s calling hours. If no call fits before expires_at, creating a task returns 400 Bad Request. Outbound calling must be enabled for the agent or the request returns 403 Forbidden. An existing task is returned with 200 OK in either case: - The same ext_id is submitted while its task is still active. - Allow re-enrollment is off and the same contact already has a task with this agent. This includes completed, canceled, and failed tasks, even when the new request uses a different ext_id. Allow re-enrollment is on by default. To change it, update the agent\u0026#x27;s outbound calling settings and publish. Returning an existing task does not restart outreach.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Alpharun\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://dev.alpharun.com/api-reference/endpoint/create-call-task\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://alpharun.mintlify.site/_mintlify/api/og/v2?division=Outbound+calling\u0026amp;title=Create+Call+Task\u0026amp;description=Schedules+an+outbound+call+and+returns+the+new+task+with+**%60201+Created%60**.%0A%0ACalls+are+scheduled+at+or+after+%60requested_at%60%2C+within+the+agent%27s+calling+hours.+I\u0026amp;theme=fd718d0cfc287b63ef7eb6ba\u0026amp;signature=6f6b11d7808e2a09e819237939f541d3f856e46e24de9789fad7fd6538265f5f\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Create Call Task - Alpharun\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Schedules an outbound call and returns the new task with 201 Created. Calls are scheduled at or after requested_at, within the agent\u0026#x27;s calling hours. If no call fits before expires_at, creating a task returns 400 Bad Request. Outbound calling must be enabled for the agent or the request returns 403 Forbidden. An existing task is returned with 200 OK in either case: - The same ext_id is submitted while its task is still active. - Allow re-enrollment is off and the same contact already has a task with this agent. This includes completed, canceled, and failed tasks, even when the new request uses a different ext_id. Allow re-enrollment is on by default. To change it, update the agent\u0026#x27;s outbound calling settings and publish. Returning an existing task does not restart outreach.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://alpharun.mintlify.site/_mintlify/api/og/v2?division=Outbound+calling\u0026amp;title=Create+Call+Task\u0026amp;description=Schedules+an+outbound+call+and+returns+the+new+task+with+**%60201+Created%60**.%0A%0ACalls+are+scheduled+at+or+after+%60requested_at%60%2C+within+the+agent%27s+calling+hours.+I\u0026amp;theme=fd718d0cfc287b63ef7eb6ba\u0026amp;signature=6f6b11d7808e2a09e819237939f541d3f856e46e24de9789fad7fd6538265f5f\">\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/alpharun/YgxLmOgl6_rcKn72/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Alpharun\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#1f3faf\">\u003clink data-mint-head rel=\"canonical\" href=\"https://dev.alpharun.com/api-reference/endpoint/create-call-task\">\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/create-call-task.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://dev.alpharun.com/#organization\",\"name\":\"Alpharun\",\"url\":\"https://dev.alpharun.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/alpharun/8IhX2s1kQ_8UHzDC/logo/light.svg?fit=max\u0026auto=format\u0026n=8IhX2s1kQ_8UHzDC\u0026q=85\u0026s=fdd2c7ebad8770f9efae37de8c31b2cc\"}},{\"@type\":\"WebSite\",\"@id\":\"https://dev.alpharun.com#website\",\"name\":\"Alpharun\",\"url\":\"https://dev.alpharun.com\",\"publisher\":{\"@id\":\"https://dev.alpharun.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://dev.alpharun.com/api-reference/endpoint/create-call-task#webpage\",\"url\":\"https://dev.alpharun.com/api-reference/endpoint/create-call-task\",\"name\":\"Create Call Task\",\"description\":\"Schedules an outbound call and returns the new task with 201 Created. Calls are scheduled at or after requested_at, within the agent's calling hours. If no call fits before expires_at, creating a task returns 400 Bad Request. Outbound calling must be enabled for the agent or the request returns 403 Forbidden. An existing task is returned with 200 OK in either case: - The same ext_id is submitted while its task is still active. - Allow re-enrollment is off and the same contact already has a task with this agent. This includes completed, canceled, and failed tasks, even when the new request uses a different ext_id. Allow re-enrollment is on by default. To change it, update the agent's outbound calling settings and publish. Returning an existing task does not restart outreach.\",\"dateModified\":\"2026-10-10T20:54:08.236Z\",\"isPartOf\":{\"@id\":\"https://dev.alpharun.com#website\"},\"breadcrumb\":{\"@id\":\"https://dev.alpharun.com/api-reference/endpoint/create-call-task#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://dev.alpharun.com/api-reference/endpoint/create-call-task#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Alpharun\",\"item\":\"https://dev.alpharun.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create Call Task\",\"item\":\"https://dev.alpharun.com/api-reference/endpoint/create-call-task\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://dev.alpharun.com/api-reference/endpoint/create-call-task#apireference\",\"headline\":\"Create Call Task\",\"name\":\"Create Call Task\",\"description\":\"Schedules an outbound call and returns the new task with 201 Created. Calls are scheduled at or after requested_at, within the agent's calling hours. If no call fits before expires_at, creating a task returns 400 Bad Request. Outbound calling must be enabled for the agent or the request returns 403 Forbidden. An existing task is returned with 200 OK in either case: - The same ext_id is submitted while its task is still active. - Allow re-enrollment is off and the same contact already has a task with this agent. This includes completed, canceled, and failed tasks, even when the new request uses a different ext_id. Allow re-enrollment is on by default. To change it, update the agent's outbound calling settings and publish. Returning an existing task does not restart outreach.\",\"url\":\"https://dev.alpharun.com/api-reference/endpoint/create-call-task\",\"mainEntityOfPage\":{\"@id\":\"https://dev.alpharun.com/api-reference/endpoint/create-call-task#webpage\"},\"dateModified\":\"2026-10-10T20:54:08.236Z\",\"publisher\":{\"@id\":\"https://dev.alpharun.com/#organization\"},\"isPartOf\":{\"@id\":\"https://dev.alpharun.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Alpharun\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Alpharun","nav":{"global":{"anchors":[{"anchor":"Help center","icon":"book-open-cover","href":"https://help.alpharun.com"}]},"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"API Reference","groups":[{"group":"API Documentation","pages":[{"title":"Introduction","href":"/api-reference/introduction"}]},{"group":"Call monitoring","pages":[{"title":"Upload Recording Asynchronously","openapi":"POST /recording-imports","href":"/api-reference/endpoint/upload-recording-async"},{"title":"Batch Import Recordings","openapi":"POST /recording-imports/batch","href":"/api-reference/endpoint/batch-import-recordings"},{"title":"Fetch Recording Import","openapi":"GET /recording-imports/{RECORDING_IMPORT_ID}","href":"/api-reference/endpoint/fetch-recording-import"},{"title":"List Recording Imports","openapi":"GET /recording-imports","href":"/api-reference/endpoint/list-recording-imports"},{"title":"Upload Recording","openapi":"POST /recordings/upload","href":"/api-reference/endpoint/upload-recording"},{"title":"Fetch Customer Interaction","openapi":"GET /customer-interactions/{CUSTOMER_INTERACTION_ID}","href":"/api-reference/endpoint/fetch-customer-interaction"},{"title":"List Playbook Customer Interactions","openapi":"GET /playbooks/{PLAYBOOK_ID}/customer-interactions","href":"/api-reference/endpoint/list-playbook-customer-interactions"},{"title":"Update Customer Interaction","openapi":"PATCH /customer-interactions/{CUSTOMER_INTERACTION_ID}","href":"/api-reference/endpoint/update-customer-interaction"},{"title":"List Transcripts For Customer Interaction","openapi":"GET /customer-interactions/{CUSTOMER_INTERACTION_ID}/transcripts","href":"/api-reference/endpoint/fetch-customer-interaction-transcripts"},{"title":"List Recordings for Customer Interaction","openapi":"GET /customer-interactions/{CUSTOMER_INTERACTION_ID}/recordings","href":"/api-reference/endpoint/list-customer-interaction-recordings"},{"title":"Fetch Customer Interaction Recording Audio","openapi":"GET /customer-interactions/{CUSTOMER_INTERACTION_ID}/recordings/{RECORDING_ID}/audio","href":"/api-reference/endpoint/fetch-customer-interaction-recording-audio"},{"title":"Customer Interaction Webhooks","description":null,"href":"/api-reference/webhook/customer-interaction-webhooks"}]},{"group":"Outbound calling","pages":[{"title":"Create Call Task","openapi":"POST /call-tasks","href":"/api-reference/endpoint/create-call-task"},{"title":"Fetch Call Task","openapi":"GET /call-tasks/{CALL_TASK_ID}","description":"Returns a call task with its current status and every attempt made so far.","href":"/api-reference/endpoint/fetch-call-task"},{"title":"Update Call Task","openapi":"PATCH /call-tasks/{CALL_TASK_ID}","href":"/api-reference/endpoint/update-call-task"},{"title":"Cancel Call Task","openapi":"DELETE /call-tasks/{CALL_TASK_ID}","href":"/api-reference/endpoint/cancel-call-task"},{"title":"List Call Tasks","openapi":"GET /call-tasks","href":"/api-reference/endpoint/list-call-tasks"},{"title":"Call Task Webhooks","href":"/api-reference/webhook/call-task-webhooks"}]},{"group":"Contacts","pages":[{"title":"Create Contact","openapi":"POST /contacts","href":"/api-reference/endpoint/create-contact"},{"title":"Fetch Contact","openapi":"GET /contacts/{CONTACT_ID}","href":"/api-reference/endpoint/fetch-contact"},{"title":"Update Contact","openapi":"PATCH /contacts","href":"/api-reference/endpoint/update-contact"},{"title":"List Contacts","openapi":"GET /contacts","href":"/api-reference/endpoint/list-contacts"},{"title":"List Contact Customer Interactions","openapi":"GET /contacts/{CONTACT_ID}/customer-interactions","href":"/api-reference/endpoint/list-contact-customer-interactions"}]},{"group":"Teammates","pages":[{"title":"Invite Teammate","openapi":"POST /teammates","href":"/api-reference/endpoint/invite-teammate"},{"title":"List Teammates","openapi":"GET /teammates","href":"/api-reference/endpoint/list-teammates"},{"title":"Fetch Teammate","openapi":"GET /teammates/{TEAMMATE_ID}","href":"/api-reference/endpoint/fetch-teammate"},{"title":"Update Teammate","openapi":"PATCH /teammates/{TEAMMATE_ID}","href":"/api-reference/endpoint/update-teammate"},{"title":"List Teammate Groups","openapi":"GET /teammate-groups","href":"/api-reference/endpoint/list-teammate-groups"}]},{"group":"Hiring","pages":[{"title":"List Job Openings","openapi":"GET /job-openings","href":"/api-reference/endpoint/list-job-openings"},{"title":"Fetch Job Opening","openapi":"GET /job-openings/{JOB_OPENING_ID}","href":"/api-reference/endpoint/get-job-opening"},{"title":"Create Job Opening","openapi":"POST /job-openings","href":"/api-reference/endpoint/create-job-opening"},{"title":"Update Job Opening","openapi":"PATCH /job-openings/{JOB_OPENING_ID}","href":"/api-reference/endpoint/update-job-opening"},{"title":"List Job Types","openapi":"GET /job-types","href":"/api-reference/endpoint/list-job-types"},{"title":"Fetch Job Type","openapi":"GET /job-types/{JOB_TYPE_ID}","href":"/api-reference/endpoint/fetch-job-type"},{"title":"Update Job Type","openapi":"PATCH /job-types/{JOB_TYPE_ID}","href":"/api-reference/endpoint/update-job-type"},{"title":"Add Candidates to Job Openings","openapi":"POST /interviews","href":"/api-reference/endpoint/add-contacts-to-job-openings"},{"title":"Remove Candidate from Job Opening","openapi":"DELETE /job-openings/{JOB_OPENING_ID}/interviews","href":"/api-reference/endpoint/remove-contact-from-job-opening"},{"title":"List Interviews for Job Opening","openapi":"GET /job-openings/{JOB_OPENING_ID}/interviews","href":"/api-reference/endpoint/list-interviews"},{"title":"Fetch Interview","openapi":"GET /job-openings/{JOB_OPENING_ID}/interviews/{INTERVIEW_ID}","href":"/api-reference/endpoint/fetch-interview"},{"title":"Fetch Interview Call Recording","openapi":"GET /job-openings/{JOB_OPENING_ID}/interviews/{INTERVIEW_ID}/calls/{CALL_ID}/recording","href":"/api-reference/endpoint/fetch-recording"},{"title":"Interview Webhooks","href":"/api-reference/webhook/interview-webhooks"}]}]}]},"basePath":"","title":"Create Call Task - Alpharun","buildId":"dpl_FWZhTb2vab28gFGFH4ojka6qEznQ","deploymentId":"dpl_FWZhTb2vab28gFGFH4ojka6qEznQ","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CBsVopKK.js","utils-DZAk68jJ.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-D32AYZrP.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-D_A5_cny.js","snippetPresets-xNRfS9th.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BIB25-tq.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CydJ4w4j.js","shallow-CYPBeQSG.js","getApiPlaygroundDisplay-A5xJVBOu.js","CodeSnippet-BVRTgi3m.js","CodeSnippets-DjD6BSlt.js","Page-Dr40SSJq.js","getPastedJson-D4V4JyrR.js","icon-uhcnG22T.js","MethodPill-CM-ZQdGH.js","DuplicateIcon-B_WnOiNf.js","createIcon-CJsb8utt.js","DynamicMarkdown-D-2HDKEp.js","SectionHeading-KP5xmMgQ.js","axios-vUo_bRtp.js","Markdown-D_k0dg6k.js","clsx-DK3K4Z1S.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DE3EVdvd.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-fN9H9n9g.js"]}