{
"message": "Insufficient balance to start this campaign. Please top up and use /check-balance to re-verify."
}
{
"message": "Provide exactly one of from_numbers / number_pool_id, not both"
}
Make large campaign calls async (Beta)
Schedule the calls of a validated large campaign: set the campaign window, calling hours, retries and caller numbers or a number pool for the bulk_list_id.
country_code must be the same dialling code as the upload. Send exactly one of from_numbers or number_pool_id: both, or neither, returns 422. from_numbers takes workspace number IDs from List workspace numbers; a number that is not in the workspace makes the campaign failed after launch. campaign_start_time and campaign_end_time (DD/MM/YYYY, HH:MM) are required unless call_slots is sent, and go together. email_completion_user_ids are workspace user IDs from List workspace users, emailed when the campaign completes.call_config has two parts:
call_time: call_start_time and call_end_time (HH:MM, defaults 09:00 and 21:00) and timezone (default Asia/Kolkata) set the daily calling hours. They replace the agent’s calling window for this campaign. scheduled_at (ISO 8601, in that timezone) schedules the start.
call_retry_config: retry_count (default 0, so leaving the block out means no retries) and the wait in minutes before retrying a busy (retry_busy), unanswered (retry_not_picked) or failed (retry_failed) call, each defaulting to 30.
call_slots limits dialling to exact windows, in call_time.timezone. Without campaign_start_time and campaign_end_time, the campaign runs from the first slot’s start to the last slot’s end.
absolute: dated intervals, each {"start": "DD/MM/YYYY, HH:MM", "end": "DD/MM/YYYY, HH:MM"}, up to 500.
weekly: windows of days (mon to sun) with start and end (HH:MM), up to 21, repeated until until (DD/MM/YYYY, HH:MM), at most 90 days ahead.
Each slot lasts 1 minute to 24 hours, is not in the past and sits inside the daily call_time window; the last one must end at least 5 minutes from now. Mixing the two modes returns 422.
concurrency_percentage (0–100) is this campaign’s share of the workspace’s concurrent calls while several campaigns are ongoing; campaigns at 0 share what is left equally.
A 402 means the balance does not cover the campaign: it moves to insufficient_balance. Add balance, run Check large campaign balance, then send this request again with the same bulk_list_id.Send each bulk_list_id once. Follow progress with Get all campaigns and the calls with call history filtered by the same bulk_list_id.
Send exactly one of from_numbers or number_pool_id; both or neither returns 422. campaign_start_time and campaign_end_time are required unless call_slots is sent, and must be sent together.
Caller numbers, as workspace number IDs from List workspace numbers (recommended) or as numbers written exactly as listed there. Send exactly one of from_numbers or number_pool_id. A number that is not in the workspace makes the campaign failed after launch.
Number pool ID. Ringg picks caller numbers from the pool, rotating numbers and skipping ones flagged as spam. Send exactly one of from_numbers or number_pool_id.
(Optional) Exact windows the campaign may dial in, in call_config.call_time.timezone. absolute lists dated intervals (DD/MM/YYYY, HH:MM); weekly repeats day-of-week windows (HH:MM). Each slot is 1 minute to 24 hours, not in the past, and inside the daily call_time window; the last must end at least 5 minutes from now. Without campaign_start_time/campaign_end_time, the campaign runs from the first slot's start to the last slot's end.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Ringg AI","description":"Build AI agents that make and answer phone calls, talk on your website and chat on WhatsApp, then run them from the Ringg AI dashboard or REST API.","colors":{"primary":"#0A0A0B","light":"#FFFFFF","dark":"#0A0A0B"},"logo":{"light":"https://mintcdn.com/ringgai-0da73d20/ZLVFI55VhZ4gmYrF/logo/light.svg?fit=max\u0026auto=format\u0026n=ZLVFI55VhZ4gmYrF\u0026q=85\u0026s=053f22dbaf5140cd8e5dadb1d4d057cd","dark":"https://mintcdn.com/ringgai-0da73d20/ZLVFI55VhZ4gmYrF/logo/dark.svg?fit=max\u0026auto=format\u0026n=ZLVFI55VhZ4gmYrF\u0026q=85\u0026s=cf9075384ec572e1a19b939d5a8674af","href":"https://www.ringg.ai"},"favicon":"https://mintcdn.com/ringgai-0da73d20/ZLVFI55VhZ4gmYrF/favicon.svg?fit=max\u0026auto=format\u0026n=ZLVFI55VhZ4gmYrF\u0026q=85\u0026s=e612fcf76df43d6468baa340dc3fde50","api":{"playground":{"display":"interactive"},"examples":{"languages":["curl","python","javascript"]},"mdx":{"auth":{"method":"key","name":"X-API-KEY"},"server":"https://prod-api.ringg.ai/ca/api/v0"}},"appearance":{"default":"dark"},"background":{"decoration":"grid"},"navbar":{"links":[{"href":"/resources/learn/all-lessons","label":"Learn"},{"href":"mailto:admin@ringg.ai","label":"Contact us"}],"primary":{"type":"button","label":"Dashboard","href":"https://www.ringg.ai/dashboard"}},"footer":{"socials":{"x":"https://x.com/ringg_ai","linkedin":"https://www.linkedin.com/company/ringg","youtube":"https://www.youtube.com/@RinggAI","instagram":"https://www.instagram.com/ringg_ai","discord":"https://discord.gg/YuEnb8Vsca"},"links":[{"header":"For AI agents","items":[{"label":"llms.txt","href":"https://docs.ringg.ai/llms.txt"},{"label":"skill.md","href":"https://docs.ringg.ai/skill.md"},{"label":"OpenAPI spec","href":"https://docs.ringg.ai/api-reference/openapi.json"},{"label":"MCP server","href":"/resources/mcp-server/docs-mcp-server/mcp-for-ai-assistants"}]}]},"search":{"prompt":"Search the docs"},"seo":{"metatags":{"canonical":"https://docs.ringg.ai","og:site_name":"Ringg AI Docs","twitter:site":"@ringg_ai"},"organization":{"id":"https://www.ringg.ai/#organization","legalName":"Stoic AI Private Limited","url":"https://www.ringg.ai","logo":"https://assets.ringg.ai/images/logo/logo.svg","sameAs":["https://x.com/ringg_ai","https://www.linkedin.com/company/ringg","https://www.youtube.com/@RinggAI","https://www.instagram.com/ringg_ai","https://discord.gg/YuEnb8Vsca"]}},"icons":{"library":"lucide"},"styling":{"eyebrows":"breadcrumbs","latex":false},"errors":{"404":{"redirect":false,"title":"This page doesn't exist","description":"It may have moved in the docs rebuild. The suggestions below usually have it; otherwise start from [the introduction](/get-started/ringg-ai) or search above."}},"contextual":{"options":["copy","view","chatgpt","claude","mcp","download-spec"],"display":"header"},"markdown":{"instructions":["To search or read these docs, connect the Ringg docs MCP server at https://docs.ringg.ai/mcp (no key needed; tools search_ringg_ai and query_docs_filesystem_ringg_ai) instead of browsing pages one by one. Setup for each client: https://docs.ringg.ai/resources/mcp-server/docs-mcp-server/mcp-for-ai-assistants.md","The dashboard labels agents \"Assistants\"; these docs say \"agent\". Both mean the same object, identified by agent_id.","API base URL: https://prod-api.ringg.ai/ca/api/v0. Send the workspace API key in the X-API-KEY header, from server-side code only.","Placing a call dials a real phone number and spends credits. Confirm the number with the user before calling.","To act on a Ringg workspace (place calls, edit agents, read transcripts), use the separate Ringg workspace MCP server at https://mcp.ringg.ai/mcp: https://docs.ringg.ai/resources/mcp-server/workspace-mcp-server/overview.md"]},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"ringgai-0da73d20","hasAudioNarration":false,"actualSubdomain":"ringgai-0da73d20","customDomains":["docs.ringg.ai"],"gitSource":{"type":"github","owner":"stonkr","repo":"ringg-api-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"feedback":{"thumbs":true,"agentFeedback":true,"edits":true,"issues":true},"entitlements":{},"buildId":"6adb52e21a579503f2299e23","clientVersion":"0.0.4102","searchFilterCounts":[{"language":"default","tag":"Documentation","count":90},{"language":"default","tag":"API reference","count":52},{"language":"default","tag":"Build agents","count":37},{"language":"default","tag":"Resources","count":34},{"language":"default","tag":"Learn","count":27},{"language":"default","tag":"Inventory","count":23},{"language":"default","tag":"Deploy","count":22},{"language":"default","tag":"Customize agent behaviour","count":19},{"language":"default","tag":"Agents","count":17},{"language":"default","tag":"Calling","count":15}],"searchSettings":{"showContentSnippets":true,"maxResults":8}},"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":"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}],"privacy":{"consentBanner":{"enabled":false}},"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"img.nav-logo{height:1.375rem!important;width:auto!important}.figure-card{display:flex;flex-direction:column;margin:0.5rem 0;overflow:hidden;border:1px solid rgb(10 10 11 / 0.08);border-radius:1rem;background:#ffffff;text-decoration:none!important;transition:border-color 150ms}.figure-card:hover{border-color:rgb(10 10 11 / 0.2)}.dark .figure-card{border-color:rgb(255 255 255 / 0.08);background:rgb(var(--background-dark))}.dark .figure-card:hover{border-color:rgb(255 255 255 / 0.2)}.figure-card-panel{display:flex;justify-content:center;height:12rem;margin:0.375rem 0.375rem 0;border-radius:0.75rem;-webkit-mask-image:linear-gradient(to bottom, #000 62%, transparent);mask-image:linear-gradient(to bottom, #000 62%, transparent);background:#f6f6f7 url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='384' height='256' fill='none' stroke='%230a0a0b' stroke-opacity='0.03' stroke-width='1.5'%3E%3Ccircle cx='32' cy='32' r='25'/%3E%3Ccircle cx='96' cy='32' r='25'/%3E%3Crect x='135' y='7' width='50' height='50' rx='8'/%3E%3Ccircle cx='224' cy='32' r='25'/%3E%3Ccircle cx='288' cy='32' r='25'/%3E%3Ccircle cx='352' cy='32' r='25'/%3E%3Ccircle cx='32' cy='96' r='25'/%3E%3Ccircle cx='96' cy='96' r='25'/%3E%3Ccircle cx='160' cy='96' r='25'/%3E%3Ccircle cx='224' cy='96' r='25'/%3E%3Ccircle cx='288' cy='96' r='25'/%3E%3Ccircle cx='352' cy='96' r='25'/%3E%3Ccircle cx='32' cy='160' r='25'/%3E%3Crect x='71' y='135' width='50' height='50' rx='8'/%3E%3Ccircle cx='160' cy='160' r='25'/%3E%3Ccircle cx='224' cy='160' r='25'/%3E%3Crect x='263' y='135' width='50' height='50' rx='8'/%3E%3Crect x='327' y='135' width='50' height='50' rx='8'/%3E%3Crect x='7' y='199' width='50' height='50' rx='8'/%3E%3Ccircle cx='96' cy='224' r='25'/%3E%3Crect x='135' y='199' width='50' height='50' rx='8'/%3E%3Ccircle cx='224' cy='224' r='25'/%3E%3Crect x='263' y='199' width='50' height='50' rx='8'/%3E%3Ccircle cx='352' cy='224' r='25'/%3E%3C/svg%3E\") center / 192px 128px}.dark .figure-card-panel{background:#0f0f11 url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='384' height='256' fill='none' stroke='%23ffffff' stroke-opacity='0.025' stroke-width='1.5'%3E%3Ccircle cx='32' cy='32' r='25'/%3E%3Ccircle cx='96' cy='32' r='25'/%3E%3Crect x='135' y='7' width='50' height='50' rx='8'/%3E%3Ccircle cx='224' cy='32' r='25'/%3E%3Ccircle cx='288' cy='32' r='25'/%3E%3Ccircle cx='352' cy='32' r='25'/%3E%3Ccircle cx='32' cy='96' r='25'/%3E%3Ccircle cx='96' cy='96' r='25'/%3E%3Ccircle cx='160' cy='96' r='25'/%3E%3Ccircle cx='224' cy='96' r='25'/%3E%3Ccircle cx='288' cy='96' r='25'/%3E%3Ccircle cx='352' cy='96' r='25'/%3E%3Ccircle cx='32' cy='160' r='25'/%3E%3Crect x='71' y='135' width='50' height='50' rx='8'/%3E%3Ccircle cx='160' cy='160' r='25'/%3E%3Ccircle cx='224' cy='160' r='25'/%3E%3Crect x='263' y='135' width='50' height='50' rx='8'/%3E%3Crect x='327' y='135' width='50' height='50' rx='8'/%3E%3Crect x='7' y='199' width='50' height='50' rx='8'/%3E%3Ccircle cx='96' cy='224' r='25'/%3E%3Crect x='135' y='199' width='50' height='50' rx='8'/%3E%3Ccircle cx='224' cy='224' r='25'/%3E%3Crect x='263' y='199' width='50' height='50' rx='8'/%3E%3Ccircle cx='352' cy='224' r='25'/%3E%3C/svg%3E\") center / 192px 128px}.figure-card-panel{--hairline-plate: #f6f6f7}.dark .figure-card-panel{--hairline-plate: #0f0f11}.figure-card-panel>[data-hairline]{width:13.75rem}.figure-card-text{flex:1;padding:0.25rem 1.25rem 1.25rem}.figure-card-title{font-weight:600;color:rgb(17 24 39)}.dark .figure-card-title{color:rgb(255 255 255)}.figure-card-body{margin-top:0.25rem;font-size:0.9375rem;line-height:1.6;color:rgb(75 85 99)}.dark .figure-card-body{color:rgb(161 161 170)}"}],"page":{"pagePath":"api-reference/calling/large-campaigns/make-large-campaign-calls-async","slug":"/api-reference/calling/large-campaigns/make-large-campaign-calls-async","pageMetadata":{"title":"Make large campaign calls async (Beta)","description":"Schedule the calls of a validated large campaign: set the campaign window, calling hours, retries and caller numbers or a number pool for the bulk_list_id.","openapi":"post /campaign/make-call-async","related":[{"Monitor a campaign":"/documentation/deploy/campaigns/manage-a-campaign"},{"Run a campaign by API":"/documentation/deploy/campaigns/campaigns-by-api#large-campaign-flow"}],"href":"/api-reference/calling/large-campaigns/make-large-campaign-calls-async"},"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: \"Schedule the calls of a validated large campaign: set the campaign window, calling hours, retries and caller numbers or a number pool for the bulk_list_id.\"\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];const RelatedTopics=({items})=>{const _components={a:`a`,..._provideComponents()},{Icon}=_components;if(!Icon)_missingMdxReference(`Icon`,true);return _jsxs(`div`,{className:`not-prose mint-mt-12`,children:[_jsx(`div`,{className:`mint-text-sm mint-font-medium mint-text-gray-500 dark:mint-text-zinc-400 mint-mb-3`,children:`Related topics`}),_jsx(`div`,{className:`mint-flex mint-flex-col mint-gap-2.5`,children:items.map(([title,href])=>_jsxs(_components.a,{href,className:`mint-flex mint-items-center mint-gap-2.5 mint-text-sm mint-text-gray-700 hover:mint-text-gray-950 dark:mint-text-zinc-300 dark:hover:mint-text-white`,children:[_jsx(Icon,{icon:`file-text`,size:16,color:`currentColor`}),title]},href))})]})};function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,_MdxComponentBoundary}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!_MdxComponentBoundary)_missingMdxReference(`_MdxComponentBoundary`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Call it once the `,_jsx(_components.a,{href:`/api-reference/calling/large-campaigns/get-large-campaign-upload-status`,children:`upload status`}),` is `,_jsx(_components.code,{children:`draft`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`fields`,children:`Fields`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`country_code`}),` must be the same dialling code as the upload. Send exactly one of `,_jsx(_components.code,{children:`from_numbers`}),` or `,_jsx(_components.code,{children:`number_pool_id`}),`: both, or neither, returns `,_jsx(_components.code,{children:`422`}),`. `,_jsx(_components.code,{children:`from_numbers`}),` takes workspace number IDs from `,_jsx(_components.a,{href:`/api-reference/inventory/numbers/get-workspace-numbers`,children:`List workspace numbers`}),`; a number that is not in the workspace makes the campaign `,_jsx(_components.code,{children:`failed`}),` after launch. `,_jsx(_components.code,{children:`campaign_start_time`}),` and `,_jsx(_components.code,{children:`campaign_end_time`}),` (`,_jsx(_components.code,{children:`DD/MM/YYYY, HH:MM`}),`) are required unless `,_jsx(_components.code,{children:`call_slots`}),` is sent, and go together. `,_jsx(_components.code,{children:`email_completion_user_ids`}),` are workspace user IDs from `,_jsx(_components.a,{href:`/api-reference/account/list-workspace-users`,children:`List workspace users`}),`, emailed when the campaign completes.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`call_config`}),` has two parts:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`call_time`}),`: `,_jsx(_components.code,{children:`call_start_time`}),` and `,_jsx(_components.code,{children:`call_end_time`}),` (`,_jsx(_components.code,{children:`HH:MM`}),`, defaults `,_jsx(_components.code,{children:`09:00`}),` and `,_jsx(_components.code,{children:`21:00`}),`) and `,_jsx(_components.code,{children:`timezone`}),` (default `,_jsx(_components.code,{children:`Asia/Kolkata`}),`) set the daily calling hours. They replace the agent’s calling window for this campaign. `,_jsx(_components.code,{children:`scheduled_at`}),` (ISO 8601, in that timezone) schedules the start.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`call_retry_config`}),`: `,_jsx(_components.code,{children:`retry_count`}),` (default `,_jsx(_components.code,{children:`0`}),`, so leaving the block out means no retries) and the wait in minutes before retrying a busy (`,_jsx(_components.code,{children:`retry_busy`}),`), unanswered (`,_jsx(_components.code,{children:`retry_not_picked`}),`) or failed (`,_jsx(_components.code,{children:`retry_failed`}),`) call, each defaulting to `,_jsx(_components.code,{children:`30`}),`.`]}),`\n`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`15`,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:`15`,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:` --request`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://prod-api.ringg.ai/ca/api/v0/campaign/make-call-async\"`}),_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:` --header`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"X-API-KEY: `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$RINGG_API_KEY`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_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:` --header`}),_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:` --data`}),_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:` \"bulk_list_id\": \"123e4567-e89b-12d3-a456-426614174000\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"agent_id\": \"your-agent-id\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"country_code\": \"+91\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"campaign_start_time\": \"18/10/2026, 09:00\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"campaign_end_time\": \"18/10/2026, 18:00\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"number_pool_id\": \"your-number-pool-id\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"call_config\": {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"call_time\": { \"call_start_time\": \"09:00\", \"call_end_time\": \"18:00\", \"timezone\": \"Asia/Kolkata\" },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"call_retry_config\": { \"retry_count\": 1, \"retry_busy\": 30, \"retry_not_picked\": 30, \"retry_failed\": 30 }`})}),`\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`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`calling-slots`,children:`Calling slots`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`call_slots`}),` limits dialling to exact windows, in `,_jsx(_components.code,{children:`call_time.timezone`}),`. Without `,_jsx(_components.code,{children:`campaign_start_time`}),` and `,_jsx(_components.code,{children:`campaign_end_time`}),`, the campaign runs from the first slot’s start to the last slot’s end.`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`absolute`}),`: dated `,_jsx(_components.code,{children:`intervals`}),`, each `,_jsx(_components.code,{children:`{\"start\": \"DD/MM/YYYY, HH:MM\", \"end\": \"DD/MM/YYYY, HH:MM\"}`}),`, up to 500.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`weekly`}),`: `,_jsx(_components.code,{children:`windows`}),` of `,_jsx(_components.code,{children:`days`}),` (`,_jsx(_components.code,{children:`mon`}),` to `,_jsx(_components.code,{children:`sun`}),`) with `,_jsx(_components.code,{children:`start`}),` and `,_jsx(_components.code,{children:`end`}),` (`,_jsx(_components.code,{children:`HH:MM`}),`), up to 21, repeated until `,_jsx(_components.code,{children:`until`}),` (`,_jsx(_components.code,{children:`DD/MM/YYYY, HH:MM`}),`), at most 90 days ahead.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Each slot lasts 1 minute to 24 hours, is not in the past and sits inside the daily `,_jsx(_components.code,{children:`call_time`}),` window; the last one must end at least 5 minutes from now. Mixing the two modes returns `,_jsx(_components.code,{children:`422`}),`.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`7`,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:`7`,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:` \"call_slots\"`}),_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:` \"mode\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"weekly\"`}),_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:` \"until\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"31/10/2026, 18:00\"`}),_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:` \"windows\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [{ `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"days\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"mon\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"wed\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"fri\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`], `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"start\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"10:00\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"end\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"13:00\"`}),_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`]})})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`concurrency_percentage`}),` (0–100) is this campaign’s share of the workspace’s concurrent calls while several campaigns are ongoing; campaigns at `,_jsx(_components.code,{children:`0`}),` share what is left equally.`]}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`5`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`5`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Campaign calls scheduled\"`}),_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:` \"bulk_list_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"123e4567-e89b-12d3-a456-426614174000\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"scheduled\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`A `,_jsx(_components.code,{children:`402`}),` means the balance does not cover the campaign: it moves to `,_jsx(_components.code,{children:`insufficient_balance`}),`. Add balance, run `,_jsx(_components.a,{href:`/api-reference/calling/large-campaigns/check-large-campaign-balance`,children:`Check large campaign balance`}),`, then send this request again with the same `,_jsx(_components.code,{children:`bulk_list_id`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`Send each `,_jsx(_components.code,{children:`bulk_list_id`}),` once. Follow progress with `,_jsx(_components.a,{href:`/api-reference/calling/campaigns/get-all-campaigns`,children:`Get all campaigns`}),` and the calls with `,_jsx(_components.a,{href:`/api-reference/monitoring/call-history/get-call-history`,children:`call history`}),` filtered by the same `,_jsx(_components.code,{children:`bulk_list_id`}),`.`]}),`\n`,_jsx(_MdxComponentBoundary,{name:`RelatedTopics`,children:_jsx(RelatedTopics,{items:[[`Monitor a campaign`,`/documentation/deploy/campaigns/manage-a-campaign`],[`Run a campaign by API`,`/documentation/deploy/campaigns/campaigns-by-api#large-campaign-flow`]]})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{RelatedTopics,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":"Make large campaign calls async (Beta)","description":"Schedule the calls of a validated large campaign: set the campaign window, calling hours, retries and caller numbers or a number pool for the bulk_list_id.","openapi":"post /campaign/make-call-async","related":[{"Monitor a campaign":"/documentation/deploy/campaigns/manage-a-campaign"},{"Run a campaign by API":"/documentation/deploy/campaigns/campaigns-by-api#large-campaign-flow"}],"href":"/api-reference/calling/large-campaigns/make-large-campaign-calls-async"}}},"mdxSourceWithNoJs":null,"noJsSplices":[[149,855,")=>null;function _cr"]]},"mdxExtracts":{"tableOfContents":[{"title":"Fields","slug":"fields","depth":2,"children":[]},{"title":"Calling slots","slug":"calling-slots","depth":2,"children":[]},{"title":"Response","slug":"response","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/ringgai-0da73d20/45c33e65ef05fabf/hairline.js"],"dynamicCss":".mint-mb-3 {\n margin-bottom: 0.75rem\n}\n.mint-mt-12 {\n margin-top: 3rem\n}\n.mint-flex {\n display: flex\n}\n.mint-flex-col {\n flex-direction: column\n}\n.mint-items-center {\n align-items: center\n}\n.mint-gap-2\\.5 {\n gap: 0.625rem\n}\n.mint-text-sm {\n font-size: 0.875rem;\n line-height: 1.25rem\n}\n.mint-font-medium {\n font-weight: 500\n}\n.mint-text-gray-500 {\n --tw-text-opacity: 1;\n color: rgb(107 114 128 / var(--tw-text-opacity, 1))\n}\n.mint-text-gray-700 {\n --tw-text-opacity: 1;\n color: rgb(55 65 81 / var(--tw-text-opacity, 1))\n}\n.hover\\:mint-text-gray-950:hover {\n --tw-text-opacity: 1;\n color: rgb(3 7 18 / var(--tw-text-opacity, 1))\n}\n.dark\\:mint-text-zinc-300:is(.dark *) {\n --tw-text-opacity: 1;\n color: rgb(212 212 216 / var(--tw-text-opacity, 1))\n}\n.dark\\:mint-text-zinc-400:is(.dark *) {\n --tw-text-opacity: 1;\n color: rgb(161 161 170 / var(--tw-text-opacity, 1))\n}\n.dark\\:hover\\:mint-text-white:hover:is(.dark *) {\n --tw-text-opacity: 1;\n color: rgb(255 255 255 / var(--tw-text-opacity, 1))\n}","openApiReferenceData":{"operation":{"tags":["campaign"],"summary":"Start Large Campaign Calls (Beta)","x-mint":{"metadata":{"og:title":"Start Large Campaign Calls Beta | Ringg AI"}},"description":"Schedule the calls of a validated large campaign: set the campaign window, calling hours, retries and caller numbers or a number pool for the bulk_list_id.","operationId":"makeCampaignCallAsyncBeta","requestBody":"3e4fa1c9-9077-4fa1-a64e-030820ecc87d","responses":{"200":"20bb65c6-af68-4ca4-834c-1df2fcfd104d","400":"f0ad809b-2735-4f9a-b1b3-b5cf777a6fbb","401":"3c5d15af-2a54-4494-b498-dd6ddb0c688d","402":"118784f2-6b41-4b30-9fbc-32ebfeb1d73f","422":"dfb5ccf1-ac6e-4083-9f25-7257bb8601a6"},"method":"post","type":"path","servers":["4e60091d-90fb-4aa4-8774-bd7b6fd296da"],"security":["8d4782e7-e89d-48a8-81fa-302bad6331cd"],"path":"/campaign/make-call-async","baseUrlOptions":["https://prod-api.ringg.ai/ca/api/v0"],"title":"Start Large Campaign Calls (Beta)","codeSamples":[],"requestExampleLanguages":["bash","python","javascript"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["bulk_list_id","agent_id","country_code","call_config"],"properties":{"bulk_list_id":{"type":"string","description":"Draft bulk list ID returned by /campaign/upload-csv.","example":"123e4567-e89b-12d3-a456-426614174000","isRequired":true,"uniqueKey":"bulk_list_id","typeLabel":"string"},"agent_id":{"type":"string","description":"Agent ID used during upload.","example":"00000000-0000-4000-8000-0000000000a1","isRequired":true,"uniqueKey":"agent_id","typeLabel":"string"},"country_code":{"type":"string","description":"Phone number country code.","example":"+91","isRequired":true,"uniqueKey":"country_code","typeLabel":"string"},"call_config":{"type":"object","properties":{"call_retry_config":{"type":"object","properties":{"retry_count":{"type":"integer","default":0,"example":1,"uniqueKey":"call_config.call_retry_config.retry_count","typeLabel":"integer"},"retry_busy":{"type":"integer","default":30,"example":30,"uniqueKey":"call_config.call_retry_config.retry_busy","typeLabel":"integer"},"retry_not_picked":{"type":"integer","default":30,"example":30,"uniqueKey":"call_config.call_retry_config.retry_not_picked","typeLabel":"integer"},"retry_failed":{"type":"integer","default":30,"example":30,"uniqueKey":"call_config.call_retry_config.retry_failed","typeLabel":"integer"}},"description":"Retries for unanswered, busy and failed calls. Without it the campaign makes no retries.","uniqueKey":"call_config.call_retry_config","typeLabel":"object"},"call_time":{"type":"object","properties":{"call_start_time":{"type":"string","default":"09:00","example":"09:00","uniqueKey":"call_config.call_time.call_start_time","typeLabel":"string"},"call_end_time":{"type":"string","default":"21:00","example":"18:00","uniqueKey":"call_config.call_time.call_end_time","typeLabel":"string"},"timezone":{"type":"string","default":"Asia/Kolkata","example":"Asia/Kolkata","uniqueKey":"call_config.call_time.timezone","typeLabel":"string"},"scheduled_at":{"oneOf":[{"type":"string","description":"ISO 8601 datetime for scheduled call (e.g. '2026-10-18T09:00:00'). Uses the timezone above.","example":null,"uniqueKey":"call_config.call_time.scheduled_at.oneOf.0","typeLabel":"string"},{"type":"null","description":"ISO 8601 datetime for scheduled call (e.g. '2026-10-18T09:00:00'). Uses the timezone above.","example":null,"uniqueKey":"call_config.call_time.scheduled_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"call_config.call_time.scheduled_at","typeLabel":"string | null"}},"uniqueKey":"call_config.call_time","typeLabel":"object"}},"isRequired":true,"uniqueKey":"call_config","typeLabel":"object"},"campaign_start_time":{"type":"string","description":"Campaign start time, `DD/MM/YYYY, HH:MM`, in `call_config.call_time.timezone`. Required unless `call_slots` is sent; send it with `campaign_end_time`.","example":"18/10/2026, 09:00","uniqueKey":"campaign_start_time","typeLabel":"string"},"campaign_end_time":{"type":"string","description":"Campaign end time, `DD/MM/YYYY, HH:MM`. Required unless `call_slots` is sent; send it with `campaign_start_time`.","example":"18/10/2026, 18:00","uniqueKey":"campaign_end_time","typeLabel":"string"},"from_numbers":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"from_numbers.oneOf.0.items.[INDEX]","typeLabel":"string"},"description":"Caller numbers, as workspace number IDs from List workspace numbers (recommended) or as numbers written exactly as listed there. Send exactly one of `from_numbers` or `number_pool_id`. A number that is not in the workspace makes the campaign `failed` after launch.","uniqueKey":"from_numbers.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string"},"description":"Caller numbers, as workspace number IDs from List workspace numbers (recommended) or as numbers written exactly as listed there. Send exactly one of `from_numbers` or `number_pool_id`. A number that is not in the workspace makes the campaign `failed` after launch.","uniqueKey":"from_numbers.oneOf.1","typeLabel":"null"}],"uniqueKey":"from_numbers","typeLabel":"string[] | null"},"number_pool_id":{"oneOf":[{"type":"string","description":"Number pool ID. Ringg picks caller numbers from the pool, rotating numbers and skipping ones flagged as spam. Send exactly one of `from_numbers` or `number_pool_id`.","example":"00000000-0000-4000-8000-0000000000b1","uniqueKey":"number_pool_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"Number pool ID. Ringg picks caller numbers from the pool, rotating numbers and skipping ones flagged as spam. Send exactly one of `from_numbers` or `number_pool_id`.","example":"00000000-0000-4000-8000-0000000000b1","uniqueKey":"number_pool_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"number_pool_id","typeLabel":"string | null"},"concurrency_percentage":{"type":"integer","minimum":0,"maximum":100,"default":0,"example":25,"description":"This campaign's share, in percent, of the workspace's concurrent calls while several campaigns are ongoing. Campaigns at `0` share what is left equally.","uniqueKey":"concurrency_percentage","typeLabel":"integer"},"email_completion_user_ids":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"email_completion_user_ids.oneOf.0.items.[INDEX]","typeLabel":"string"},"uniqueKey":"email_completion_user_ids.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string"},"uniqueKey":"email_completion_user_ids.oneOf.1","typeLabel":"null"}],"uniqueKey":"email_completion_user_ids","typeLabel":"string[] | null"},"call_slots":{"oneOf":[{"type":"object","description":"(Optional) Exact windows the campaign may dial in, in `call_config.call_time.timezone`. `absolute` lists dated intervals (`DD/MM/YYYY, HH:MM`); `weekly` repeats day-of-week windows (`HH:MM`). Each slot is 1 minute to 24 hours, not in the past, and inside the daily `call_time` window; the last must end at least 5 minutes from now. Without `campaign_start_time`/`campaign_end_time`, the campaign runs from the first slot's start to the last slot's end.","required":["mode","intervals"],"properties":{"mode":{"type":"string","enum":["absolute"],"isRequired":true,"uniqueKey":"call_slots.oneOf.0.mode","typeLabel":"enum\u003cstring>"},"intervals":{"type":"array","maxItems":500,"items":{"type":"object","required":["start","end"],"properties":{"start":{"type":"string","example":"18/10/2026, 10:00","isRequired":true,"uniqueKey":"call_slots.oneOf.0.intervals.items.[INDEX].start","typeLabel":"string"},"end":{"type":"string","example":"18/10/2026, 13:00","isRequired":true,"uniqueKey":"call_slots.oneOf.0.intervals.items.[INDEX].end","typeLabel":"string"}},"uniqueKey":"call_slots.oneOf.0.intervals.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"call_slots.oneOf.0.intervals","typeLabel":"object[]"}},"uniqueKey":"call_slots.oneOf.0","typeLabel":"object"},{"type":"object","description":"(Optional) Exact windows the campaign may dial in, in `call_config.call_time.timezone`. `absolute` lists dated intervals (`DD/MM/YYYY, HH:MM`); `weekly` repeats day-of-week windows (`HH:MM`). Each slot is 1 minute to 24 hours, not in the past, and inside the daily `call_time` window; the last must end at least 5 minutes from now. Without `campaign_start_time`/`campaign_end_time`, the campaign runs from the first slot's start to the last slot's end.","required":["mode","until","windows"],"properties":{"mode":{"type":"string","enum":["weekly"],"isRequired":true,"uniqueKey":"call_slots.oneOf.1.mode","typeLabel":"enum\u003cstring>"},"until":{"type":"string","description":"`DD/MM/YYYY, HH:MM`. Windows repeat from `campaign_start_time` (or now) until this time, at most 90 days.","example":"31/10/2026, 18:00","isRequired":true,"uniqueKey":"call_slots.oneOf.1.until","typeLabel":"string"},"windows":{"type":"array","maxItems":21,"items":{"type":"object","required":["days","start","end"],"properties":{"days":{"type":"array","items":{"type":"string","enum":["mon","tue","wed","thu","fri","sat","sun"],"uniqueKey":"call_slots.oneOf.1.windows.items.[INDEX].days.items.[INDEX]","typeLabel":"enum\u003cstring>"},"example":["mon","wed","fri"],"isRequired":true,"uniqueKey":"call_slots.oneOf.1.windows.items.[INDEX].days","typeLabel":"enum\u003cstring>[]"},"start":{"type":"string","example":"10:00","isRequired":true,"uniqueKey":"call_slots.oneOf.1.windows.items.[INDEX].start","typeLabel":"string"},"end":{"type":"string","example":"13:00","isRequired":true,"uniqueKey":"call_slots.oneOf.1.windows.items.[INDEX].end","typeLabel":"string"}},"uniqueKey":"call_slots.oneOf.1.windows.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"call_slots.oneOf.1.windows","typeLabel":"object[]"}},"uniqueKey":"call_slots.oneOf.1","typeLabel":"object"}],"uniqueKey":"call_slots","typeLabel":"object"}},"description":"Send exactly one of `from_numbers` or `number_pool_id`; both or neither returns 422. `campaign_start_time` and `campaign_end_time` are required unless `call_slots` is sent, and must be sent together.","uniqueKey":"","typeLabel":"object"},"examples":{"number_pool":{"title":"number_pool","value":{"bulk_list_id":"123e4567-e89b-12d3-a456-426614174000","agent_id":"00000000-0000-4000-8000-0000000000a1","country_code":"+91","campaign_start_time":"18/10/2026, 09:00","campaign_end_time":"18/10/2026, 18:00","number_pool_id":"00000000-0000-4000-8000-0000000000b1","call_config":{"call_time":{"call_start_time":"09:00","call_end_time":"18:00","timezone":"Asia/Kolkata"},"call_retry_config":{"retry_count":1,"retry_busy":30,"retry_not_picked":30,"retry_failed":30}}}},"from_numbers":{"title":"from_numbers","value":{"bulk_list_id":"123e4567-e89b-12d3-a456-426614174000","agent_id":"00000000-0000-4000-8000-0000000000a1","country_code":"+91","campaign_start_time":"18/10/2026, 09:00","campaign_end_time":"18/10/2026, 18:00","from_numbers":["00000000-0000-4000-8000-0000000000c1"],"call_config":{"call_time":{"call_start_time":"09:00","call_end_time":"18:00","timezone":"Asia/Kolkata"},"call_retry_config":{"retry_count":1,"retry_busy":30,"retry_not_picked":30,"retry_failed":30}}}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"20bb65c6-af68-4ca4-834c-1df2fcfd104d":{"description":"Large campaign call creation accepted.","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","uniqueKey":"message","typeLabel":"string"},"bulk_list_id":{"type":"string","uniqueKey":"bulk_list_id","typeLabel":"string"},"status":{"type":"string","uniqueKey":"status","typeLabel":"string"}},"example":{"message":"Campaign calls scheduled","bulk_list_id":"123e4567-e89b-12d3-a456-426614174000","status":"scheduled"},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"Campaign calls scheduled","bulk_list_id":"123e4567-e89b-12d3-a456-426614174000","status":"scheduled"}}},"exampleType":"generated"}},"exampleType":"generated"},"f0ad809b-2735-4f9a-b1b3-b5cf777a6fbb":{"description":"Bad Request - Invalid input.","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Bulk list is not ready to start.","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"Bulk list is not ready to start."}}},"exampleType":"generated"}},"exampleType":"generated"},"3c5d15af-2a54-4494-b498-dd6ddb0c688d":{"description":"Unauthorized - Invalid or missing authentication.","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Invalid credentials","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"Invalid credentials"}}},"exampleType":"generated"}},"exampleType":"generated"},"118784f2-6b41-4b30-9fbc-32ebfeb1d73f":{"description":"Payment Required - The balance (or available credit limit) does not cover the campaign. The campaign is set to `insufficient_balance`; add balance, call Check Campaign Balance, then send this request again.","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Insufficient balance to start this campaign. Please top up and use /check-balance to re-verify.","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"Insufficient balance to start this campaign. Please top up and use /check-balance to re-verify."}}},"exampleType":"generated"}},"exampleType":"generated"},"dfb5ccf1-ac6e-4083-9f25-7257bb8601a6":{"description":"Validation Error - Both or neither of `from_numbers` and `number_pool_id`, only one of `campaign_start_time` and `campaign_end_time`, invalid `call_slots`, or a field with the wrong type.","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Provide exactly one of from_numbers / number_pool_id, not both","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"Provide exactly one of from_numbers / number_pool_id, not both"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"8d4782e7-e89d-48a8-81fa-302bad6331cd":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-KEY","scopes":[],"schemeName":"ApiKeyAuth"}}},"servers":{"4e60091d-90fb-4aa4-8774-bd7b6fd296da":{"url":"https://prod-api.ringg.ai/ca/api/v0"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-API-KEY","scopes":[],"schemeName":"ApiKeyAuth"},"schema":{"title":"X-API-KEY","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKeyAuth","name":"X-API-KEY"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"ringgai-0da73d20","siteName":"Ringg AI","title":"Make large campaign calls async (Beta) - Ringg AI","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-13T11:53:24.652Z","originalFileLocation":"api-reference/calling/large-campaigns/make-large-campaign-calls-async.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=\"dark\"}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=\"Schedule the calls of a validated large campaign: set the campaign window, calling hours, retries and caller numbers or a number pool for the bulk_list_id.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Ringg AI\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/ringgai-0da73d20/p7P0VdTXwvUPgoLE/_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/ringgai-0da73d20/p7P0VdTXwvUPgoLE/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/ringgai-0da73d20/p7P0VdTXwvUPgoLE/_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/ringgai-0da73d20/p7P0VdTXwvUPgoLE/_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/ringgai-0da73d20/p7P0VdTXwvUPgoLE/_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/ringgai-0da73d20/p7P0VdTXwvUPgoLE/_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/ringgai-0da73d20/p7P0VdTXwvUPgoLE/_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/ringgai-0da73d20/p7P0VdTXwvUPgoLE/_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/ringgai-0da73d20/p7P0VdTXwvUPgoLE/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Make large campaign calls async (Beta) - Ringg AI\">\u003cmeta data-mint-head property=\"og:description\" content=\"Schedule the calls of a validated large campaign: set the campaign window, calling hours, retries and caller numbers or a number pool for the bulk_list_id.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Ringg AI Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.ringg.ai/api-reference/calling/large-campaigns/make-large-campaign-calls-async\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://ringgai-0da73d20.mintlify.site/_mintlify/api/og/v2?division=Large+campaigns\u0026amp;title=Make+large+campaign+calls+async+%28Beta%29\u0026amp;description=Schedule+the+calls+of+a+validated+large+campaign%3A+set+the+campaign+window%2C+calling+hours%2C+retries+and+caller+numbers+or+a+number+pool+for+the+bulk_list_id.\u0026amp;theme=737b8671029ef070100737b1\u0026amp;signature=a9a2f3d9e26a8c7fb0b91b091200fc0f41e16acd695c9d8e8ffd2040b7f8a777\">\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=\"Make large campaign calls async (Beta) - Ringg AI\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Schedule the calls of a validated large campaign: set the campaign window, calling hours, retries and caller numbers or a number pool for the bulk_list_id.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://ringgai-0da73d20.mintlify.site/_mintlify/api/og/v2?division=Large+campaigns\u0026amp;title=Make+large+campaign+calls+async+%28Beta%29\u0026amp;description=Schedule+the+calls+of+a+validated+large+campaign%3A+set+the+campaign+window%2C+calling+hours%2C+retries+and+caller+numbers+or+a+number+pool+for+the+bulk_list_id.\u0026amp;theme=737b8671029ef070100737b1\u0026amp;signature=a9a2f3d9e26a8c7fb0b91b091200fc0f41e16acd695c9d8e8ffd2040b7f8a777\">\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/ringgai-0da73d20/p7P0VdTXwvUPgoLE/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Ringg AI\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0A0A0B\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.ringg.ai/api-reference/calling/large-campaigns/make-large-campaign-calls-async\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/calling/large-campaigns/make-large-campaign-calls-async.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://www.ringg.ai/#organization\",\"name\":\"Ringg AI\",\"legalName\":\"Stoic AI Private Limited\",\"url\":\"https://www.ringg.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://assets.ringg.ai/images/logo/logo.svg\"},\"sameAs\":[\"https://x.com/ringg_ai\",\"https://www.linkedin.com/company/ringg\",\"https://www.youtube.com/@RinggAI\",\"https://www.instagram.com/ringg_ai\",\"https://discord.gg/YuEnb8Vsca\"]},{\"@type\":\"WebSite\",\"@id\":\"https://docs.ringg.ai#website\",\"name\":\"Ringg AI\",\"url\":\"https://docs.ringg.ai\",\"publisher\":{\"@id\":\"https://www.ringg.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.ringg.ai/api-reference/calling/large-campaigns/make-large-campaign-calls-async#webpage\",\"url\":\"https://docs.ringg.ai/api-reference/calling/large-campaigns/make-large-campaign-calls-async\",\"name\":\"Make large campaign calls async (Beta)\",\"description\":\"Schedule the calls of a validated large campaign: set the campaign window, calling hours, retries and caller numbers or a number pool for the bulk_list_id.\",\"dateModified\":\"2026-10-13T11:53:24.652Z\",\"isPartOf\":{\"@id\":\"https://docs.ringg.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.ringg.ai/api-reference/calling/large-campaigns/make-large-campaign-calls-async#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.ringg.ai/api-reference/calling/large-campaigns/make-large-campaign-calls-async#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Calling\",\"item\":\"https://docs.ringg.ai/api-reference/calling/individual-calls/initiate-individual-call\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Large campaigns\",\"item\":\"https://docs.ringg.ai/api-reference/calling/large-campaigns/upload-large-campaign-csv\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Make large campaign calls async (Beta)\",\"item\":\"https://docs.ringg.ai/api-reference/calling/large-campaigns/make-large-campaign-calls-async\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.ringg.ai/api-reference/calling/large-campaigns/make-large-campaign-calls-async#apireference\",\"headline\":\"Make large campaign calls async (Beta)\",\"name\":\"Make large campaign calls async (Beta)\",\"description\":\"Schedule the calls of a validated large campaign: set the campaign window, calling hours, retries and caller numbers or a number pool for the bulk_list_id.\",\"url\":\"https://docs.ringg.ai/api-reference/calling/large-campaigns/make-large-campaign-calls-async\",\"mainEntityOfPage\":{\"@id\":\"https://docs.ringg.ai/api-reference/calling/large-campaigns/make-large-campaign-calls-async#webpage\"},\"dateModified\":\"2026-10-13T11:53:24.652Z\",\"publisher\":{\"@id\":\"https://www.ringg.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.ringg.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Ringg AI\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Ringg AI\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/calling/large-campaigns/make-large-campaign-calls-async.md","siteName":"Ringg AI","nav":{"global":null,"tabs":[{"tab":"Get started","pages":[{"title":"Get started","href":"/get-started/introduction"}]},{"tab":"Documentation","pages":[{"title":"Documentation","href":"/documentation/introduction"}]},{"tab":"Analytics platform","pages":[{"title":"Analytics platform","href":"/analytics-platform/introduction"}]},{"tab":"API reference","groups":[{"group":"Introduction","icon":"book-open","pages":[{"title":"API quickstart","sidebarTitle":"Quickstart","href":"/api-reference/introduction/quickstart"},{"title":"Authentication","href":"/api-reference/introduction/authentication"},{"title":"API Overview","href":"/api-reference/introduction/api-overview"}]},{"group":"Agents","icon":"bot","pages":[{"openapi":"get /agent/all","title":"List Agents","href":"/api-reference/agents/get-assistants"},{"openapi":"get /agent/{agent_id}","title":"Get Agent","href":"/api-reference/agents/get-assistant-by-id"},{"openapi":"post /public/agent","title":"Create Agent","href":"/api-reference/agents/create-agent"},{"openapi":"patch /agent/v1","title":"Edit Agent Settings","href":"/api-reference/agents/edit-assistant"},{"openapi":"get /agent/voices","title":"List Voices","href":"/api-reference/agents/get-assistant-voices"}]},{"group":"Inventory","icon":"package","pages":[{"group":"Knowledge bases","expanded":true,"pages":[{"openapi":"post /external/kb","title":"Create Knowledge Base","href":"/api-reference/inventory/knowledge-bases/create-knowledge-base"},{"openapi":"get /external/kb/all","title":"Get All Knowledge Bases","href":"/api-reference/inventory/knowledge-bases/get-all-knowledge-bases"},{"openapi":"get /external/kb/{kb_id}","title":"Get Knowledge Base by ID","href":"/api-reference/inventory/knowledge-bases/get-knowledge-base-by-id"},{"openapi":"patch /external/kb","title":"Edit Knowledge Base","href":"/api-reference/inventory/knowledge-bases/edit-knowledge-base"},{"openapi":"delete /external/kb/{kb_id}","title":"Delete Knowledge Base","href":"/api-reference/inventory/knowledge-bases/delete-knowledge-base"}]},{"group":"Numbers","expanded":true,"pages":[{"openapi":"get /workspace/numbers","title":"Get Workspace Numbers","href":"/api-reference/inventory/numbers/get-workspace-numbers"}]}]},{"group":"Calling","icon":"phone","pages":[{"group":"Individual calls","expanded":true,"pages":[{"openapi":"post /calling/outbound/individual","title":"Initiate Individual Call","href":"/api-reference/calling/individual-calls/initiate-individual-call"},{"openapi":"post /calling/v2/outbound/individual","title":"Initiate Individual Call (Number Pool)","href":"/api-reference/calling/individual-calls/initiate-individual-call-v2"},{"title":"Terminate Calls by Call IDs","sidebarTitle":"Stop calls by ID","api":"PATCH /campaign/terminate","href":"/api-reference/calling/individual-calls/stop-calls-by-id"},{"title":"Terminate Calls by Numbers","sidebarTitle":"Stop calls to numbers","api":"PATCH /campaign/terminate","href":"/api-reference/calling/individual-calls/stop-calls-to-numbers"},{"title":"Terminate All Calls by Agent ID","sidebarTitle":"Stop an agent's calls","api":"PATCH /campaign/terminate","href":"/api-reference/calling/individual-calls/stop-agent-calls"}]},{"group":"Campaigns","expanded":true,"pages":[{"openapi":"post /campaign/save","title":"Upload Campaign Contact List","href":"/api-reference/calling/campaigns/upload-campaign-contact-list"},{"openapi":"post /campaign/start","title":"Start Campaign","href":"/api-reference/calling/campaigns/start-campaign"},{"openapi":"post /campaign/v2/start","title":"Start Campaign (Number Pool)","href":"/api-reference/calling/campaigns/start-campaign-v2"},{"openapi":"get /campaign/all","title":"Get All Campaigns","href":"/api-reference/calling/campaigns/get-all-campaigns"},{"title":"Terminate Calls by Campaign ID","sidebarTitle":"Stop a campaign","api":"PATCH /campaign/terminate","href":"/api-reference/calling/campaigns/stop-campaign"},{"title":"Terminate Calls by Campaign Numbers","sidebarTitle":"Stop numbers in a campaign","api":"PATCH /campaign/terminate","href":"/api-reference/calling/campaigns/stop-campaign-numbers"}]},{"group":"Large campaigns","tag":"BETA","expanded":true,"pages":[{"title":"Upload large campaign CSV (Beta)","openapi":"post /campaign/upload-csv","href":"/api-reference/calling/large-campaigns/upload-large-campaign-csv"},{"title":"Get large campaign upload status (Beta)","openapi":"get /campaign/upload-status/{bulk_list_id}","href":"/api-reference/calling/large-campaigns/get-large-campaign-upload-status"},{"title":"Check large campaign balance (Beta)","description":"Re-check the workspace balance for a large campaign that stopped at insufficient_balance, after a top-up, so it returns to draft and calls can start.","openapi":"post /campaign/check-balance/{bulk_list_id}","href":"/api-reference/calling/large-campaigns/check-large-campaign-balance"},{"title":"Make large campaign calls async (Beta)","openapi":"post /campaign/make-call-async","href":"/api-reference/calling/large-campaigns/make-large-campaign-calls-async"}]}]},{"group":"Monitoring","icon":"chart-column","pages":[{"group":"Call history","expanded":true,"pages":[{"openapi":"get /calling/history","description":"List calls in your workspace by date range, agent, status or campaign, with transcript, recording link, duration and cost, to reconcile results or backfill.","title":"Get Call History","href":"/api-reference/monitoring/call-history/get-call-history"},{"openapi":"get /calling/call-details","title":"Get Call Details","href":"/api-reference/monitoring/call-history/get-call-details"},{"openapi":"post /calling/history/download","title":"Download Call History","href":"/api-reference/monitoring/call-history/download-call-history"}]},{"group":"Analytics","tag":"NEW","expanded":true,"pages":[{"openapi":"get /analytics/v4/volume-graph","title":"Get Volume Analytics","href":"/api-reference/monitoring/analytics/get-volume-analytics"},{"openapi":"get /analytics/v4/connectivity","title":"Get Connectivity Analytics","href":"/api-reference/monitoring/analytics/get-connectivity-analytics"},{"openapi":"get /analytics/v4/agent-performance","title":"Get Agent Performance","href":"/api-reference/monitoring/analytics/get-agent-performance"},{"openapi":"get /analytics/v4/latency-trend","title":"Get Latency Trend","href":"/api-reference/monitoring/analytics/get-latency-trend"},{"openapi":"get /analytics/v4/concurrency-trend","title":"Get Concurrency Trend","href":"/api-reference/monitoring/analytics/get-concurrency-trend"},{"openapi":"get /analytics/v4/cohort/dimensions","title":"Get Cohort Dimensions","href":"/api-reference/monitoring/analytics/get-cohort-dimensions"},{"openapi":"get /analytics/v4/cohort/values","title":"Get Cohort Values","href":"/api-reference/monitoring/analytics/get-cohort-values"},{"openapi":"get /analytics/v4/cohort/breakdown","title":"Get Cohort Breakdown","href":"/api-reference/monitoring/analytics/get-cohort-breakdown"},{"openapi":"get /analytics/v4/campaigns","title":"Get Active Campaigns","href":"/api-reference/monitoring/analytics/get-active-campaigns"},{"openapi":"get /analytics/v4/data-freshness","title":"Get Data Freshness","href":"/api-reference/monitoring/analytics/get-data-freshness"},{"openapi":"get /analytics/v4/chat-analytics","title":"Get Chat Analytics","href":"/api-reference/monitoring/analytics/get-chat-analytics"}]}]},{"group":"Account","icon":"settings","pages":[{"openapi":"get /workspace","title":"Get Workspace Info","href":"/api-reference/account/get-workspace-info"},{"openapi":"get /workspace/users","title":"List Workspace Users","href":"/api-reference/account/list-workspace-users"},{"openapi":"get /workspace/all","title":"Get All User Workspaces","href":"/api-reference/account/get-all-user-workspaces"},{"group":"Ringg Spaces","expanded":true,"pages":[{"openapi":"post /workspace/sub","title":"Create Ringg Space","href":"/api-reference/account/ringg-spaces/create-sub-workspace"},{"openapi":"get /workspace/sub","title":"Get Ringg Spaces","href":"/api-reference/account/ringg-spaces/get-sub-workspaces"},{"openapi":"get /workspace/sub/members","title":"List Family Members","href":"/api-reference/account/ringg-spaces/list-family-members"},{"openapi":"patch /workspace/sub/{sub_workspace_id}/concurrency","title":"Allocate Concurrency to a Ringg Space","href":"/api-reference/account/ringg-spaces/allocate-concurrency"},{"openapi":"patch /workspace/sub/credit-limits","title":"Reallocate Credit Limits","href":"/api-reference/account/ringg-spaces/reallocate-credit-limits"},{"openapi":"patch /workspace/sub/credit-balances","title":"Reallocate Credit Balances","href":"/api-reference/account/ringg-spaces/reallocate-credit-balances"}]}]}]},{"tab":"Resources","menu":[{"item":"MCP server","description":"Let Claude, ChatGPT or Cursor work in your workspace, or search these docs","pages":[{"title":"MCP server","href":"/resources/mcp-server/docs-mcp-server/mcp-for-ai-assistants"}]},{"item":"Learn","description":"Lessons that build a payment-reminder system end to end","pages":[{"title":"Learn","href":"/resources/learn/all-lessons"}]},{"item":"Security","description":"How Ringg protects your data, and what to do on your side","pages":[{"title":"Security","href":"/resources/security/security"}]},{"item":"Changelog","description":"New features, API changes and new guides","pages":[{"title":"Changelog","href":"/resources/changelog/changelog"}]}],"pages":[{"title":"Resources","href":"/resources/mcp-server/docs-mcp-server/mcp-for-ai-assistants"}]}]},"basePath":"","title":"Make large campaign calls async (Beta) - Ringg AI","buildId":"dpl_596ePT575z4qnAFksq1biRW97aLY","deploymentId":"dpl_596ePT575z4qnAFksq1biRW97aLY","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-C9Wu0MeN.js","utils-jWgu-6Qf.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DBD8f9qn.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-BGuX1ui5.js","snippetPresets-Evy63nQB.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BQHO1lnV.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-B6C8m-t_.js","shallow-BG4cT0fH.js","getApiPlaygroundDisplay-CgEPrE-D.js","CodeSnippet-CU8JyZ9N.js","CodeSnippets-BnxHU32T.js","Page-D6S0Yh6q.js","getPastedJson-CwiYOonh.js","icon-DYDpWmDf.js","MethodPill-C-J-l7_c.js","DuplicateIcon-B6ARwg9w.js","createIcon-Dsv4MtDq.js","DynamicMarkdown-CtasenyM.js","SectionHeading-YNcgYwjB.js","axios-vUo_bRtp.js","Markdown-CwLx6PAg.js","clsx-C3kuh_dz.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CmKHfscc.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-U3mI6Ljh.js"]}