Upload up to 100,000 recipients and track background execution as one task.
Use /bulk-tasks when your recipient list exceeds the existing 1,000-recipient batch limit. One task accepts up to 100,000 recipients. It stores numbered upload chunks and prepares smaller child batches in the background after you explicitly start it. The existing /batches and /sms-batches endpoints keep their limits.
Create an upload-only task
POST /bulk-tasks requires Idempotency-Key. Choose kind: sms or kind: calls. SMS uses recipient_format: recipients; calls accept either recipients or contact_ids. options uses the corresponding existing batch settings, including schedules, per-recipient variables, references, callbacks and test_mode.
Creating and uploading do not send messages or dial. Call tasks use options.agent_id. Every mutation requires batches:write for calls or sms:send for SMS. Reads require the corresponding batches:read or sms:read; having a scope for the other kind grants no access.
Upload the complete recipient list
Send PUT /bulk-tasks/{task_id}/chunks/{chunk_index} with {"recipients": [...]}. Indexes start at 0. Every chunk must contain exactly upload_chunk_size recipients, except the last chunk. For a call task using contact_ids, the array contains UUID strings. Otherwise it contains the existing inline call or SMS recipient objects.Upload sequentially. An unchanged index and body is safe to retry with the same key, including after a timeout. Different content at an existing index returns 409 idempotency_conflict. Duplicate phones, contact IDs and inline call external identities anywhere in a task reject the entire new chunk. The creating API key must perform uploads and start.
// task is the create response; recipients is your complete local list.for (let offset = 0; offset < recipients.length; offset += task.upload_chunk_size) { const index = offset / task.upload_chunk_size; // uploadChunk wraps PUT /bulk-tasks/{task_id}/chunks/{chunk_index}. const response = await uploadChunk(task.id, index, { recipients: recipients.slice(offset, offset + task.upload_chunk_size), }, { idempotencyKey: `${task.id}-chunk-${index}` }); if (!response.ok) throw new Error(`Upload paused at chunk ${index}: ${response.status}`);}
Each JSON request must fit the existing 1 MiB limit. Select a smaller upload_chunk_size (1–1,000) when recipient variables are large. If interrupted, resume using the same task, indexes, bodies and idempotency keys. Handle 429 using the rate-limit response headers.
Start background execution
Send POST /bulk-tasks/{task_id}/start with {} and an Idempotency-Key. An incomplete upload returns 400 validation_error with upload_incomplete. Starting again is safe and never duplicates the task’s child batches.
Starting a task authorizes real SMS sending or AI phone calls to its recipients, at its configured time. Use test_mode: true while integrating; it creates test results without carrier sends, dial commands or charges.
The scheduled worker prepares up to 10 SMS recipients or 100 call recipients per part, checking current key authority and destination rules. Revoked or expired keys prevent future parts from being submitted. The existing carrier, billing, call concurrency, calling-window and retry rules still apply. Large tasks may take multiple worker cycles; a requested schedule does not promise simultaneous delivery.Only one bulk call child per organization is active at a time, across all of its tasks, so a large task cannot fill the shared dialer shortlist. SMS preparation waits until its start time and pauses when the due delivery backlog reaches 500 recipients; this prevents mass preparation from outrunning the existing delivery worker and expiring unsent messages. Preparation runs on its own authenticated minute schedule with a 24-second cancellation deadline.
Track progress and investigate failures
GET /bulk-tasks/{task_id} reports uploaded_recipients, submitted_recipients, settled_recipients, failed_recipients, unknown_recipients and part counts. completed means every recipient has a settled result, including failures. It does not mean every SMS was delivered or every call was answered. Unknown SMS delivery remains unsettled; do not resend it in a new task.GET /bulk-tasks/{task_id}/parts returns at most 100 parts. Follow next_after using ?after=.... Each submitted part includes batch_id, which uses the existing SMS or call batch query endpoints. Failed preparation parts include a fixed error_code; failed_recipients counts execution failures, while failed_parts identifies preparation failures that never submitted recipients.Preparation failures make the task failed; previously submitted and other pending parts may continue. Task-wide cancellation and automatic replay of permanently failed parts are not provided. Use existing call batch pause/cancel endpoints for submitted call parts. Canonical contacts that resolve to the same person across call parts are rejected before that part starts. Never recreate the entire task to retry a partial or uncertain result.The MCP equivalents are brightalk_create_bulk_task, brightalk_upload_bulk_task_chunk, brightalk_start_bulk_task, brightalk_get_bulk_task and brightalk_list_bulk_task_parts.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Brightalk Developer Documentation","description":"Connect server-side systems to Brightalk AI calling with the REST API.","colors":{"primary":"#141414","light":"#FFFFFF","dark":"#1FA181"},"logo":{"light":"https://mintcdn.com/brightalk/cNN7numzDpngkdaF/images/logo-dark.svg?fit=max\u0026auto=format\u0026n=cNN7numzDpngkdaF\u0026q=85\u0026s=a5c61d9f016336ae5b4e15fbbd7a861b","dark":"https://mintcdn.com/brightalk/cNN7numzDpngkdaF/images/logo-light.svg?fit=max\u0026auto=format\u0026n=cNN7numzDpngkdaF\u0026q=85\u0026s=b4ca37683eb8ae7f42031d1d34613bd6"},"favicon":"https://mintcdn.com/brightalk/cNN7numzDpngkdaF/images/favicon.svg?fit=max\u0026auto=format\u0026n=cNN7numzDpngkdaF\u0026q=85\u0026s=8ac74a9d28bd0d3cb2f2351f4159aed1","api":{"playground":{"display":"interactive","proxy":true},"examples":{"languages":["curl","javascript","python"],"prefill":false,"autogenerate":false}},"search":{"prompt":"搜尋文件 / Search documentation"},"seo":{"metatags":{"canonical":"https://docs.brightalk.ai"}},"styling":{"latex":false},"navigation":{"languages":[{"language":"zh-Hant","default":true,"navbar":{"primary":{"type":"button","label":"API 設定","href":"https://www.brightalk.ai/settings/integrations/api"}},"href":"zh-Hant/introduction"},{"language":"en","navbar":{"primary":{"type":"button","label":"API settings","href":"https://www.brightalk.ai/settings/integrations/api"}},"href":"en/introduction"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"brightalk","hasAudioNarration":false,"actualSubdomain":"brightalk","customDomains":["docs.brightalk.ai"],"gitSource":{"type":"github","owner":"dexterdotbuzz","repo":"ai-native-crm","deployBranch":"main","contentDirectory":"developer-docs","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6afb04df2e18d8b81a1ccabf","clientVersion":"0.0.4167","searchFilterCounts":[{"language":"en","tag":"API reference","count":41},{"language":"zh-Hant","tag":"API 參考","count":41},{"language":"en","tag":"Batches","count":12},{"language":"zh-Hant","tag":"批次撥號","count":12},{"language":"en","tag":"Integrations","count":9},{"language":"zh-Hant","tag":"Integrations","count":9},{"language":"en","tag":"Guides","count":8},{"language":"zh-Hant","tag":"操作指南","count":8},{"language":"en","tag":"Core concepts","count":7},{"language":"zh-Hant","tag":"核心概念","count":7},{"language":"en","tag":"Calls","count":6},{"language":"zh-Hant","tag":"Calls","count":6},{"language":"en","tag":"API fundamentals","count":5},{"language":"zh-Hant","tag":"API 基礎","count":5},{"language":"en","tag":"Automation runs","count":4},{"language":"en","tag":"Contacts","count":4},{"language":"zh-Hant","tag":"Contacts","count":4},{"language":"zh-Hant","tag":"自動化執行","count":4},{"language":"en","tag":"Get started","count":3},{"language":"zh-Hant","tag":"開始使用","count":3}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"en/guides/large-tasks","slug":"/en/guides/large-tasks","pageMetadata":{"title":"Large SMS and call tasks","description":"Upload up to 100,000 recipients and track background execution as one task.","href":"/en/guides/large-tasks"},"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: \"Upload up to 100,000 recipients and track background execution as one task.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,pre:`pre`,span:`span`,..._provideComponents(),...props.components},{CodeBlock,Heading,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Use `,_jsx(_components.code,{children:`/bulk-tasks`}),` when your recipient list exceeds the existing 1,000-recipient batch limit. One task accepts up to 100,000 recipients. It stores numbered upload chunks and prepares smaller child batches in the background after you explicitly start it. The existing `,_jsx(_components.code,{children:`/batches`}),` and `,_jsx(_components.code,{children:`/sms-batches`}),` endpoints keep their limits.`]}),`\n`,_jsx(Heading,{level:`2`,id:`create-an-upload-only-task`,children:`Create an upload-only task`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`POST /bulk-tasks`}),` requires `,_jsx(_components.code,{children:`Idempotency-Key`}),`. Choose `,_jsx(_components.code,{children:`kind: sms`}),` or `,_jsx(_components.code,{children:`kind: calls`}),`. SMS uses `,_jsx(_components.code,{children:`recipient_format: recipients`}),`; calls accept either `,_jsx(_components.code,{children:`recipients`}),` or `,_jsx(_components.code,{children:`contact_ids`}),`. `,_jsx(_components.code,{children:`options`}),` uses the corresponding existing batch settings, including schedules, per-recipient variables, references, callbacks and `,_jsx(_components.code,{children:`test_mode`}),`.`]}),`\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:` \"kind\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"sms\"`}),_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:` \"total_recipients\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`10000`}),_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:` \"recipient_format\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"recipients\"`}),_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:` \"upload_chunk_size\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1000`}),_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:` \"options\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},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:`\"Hello {{name}}\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"test_mode\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_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:[`Creating and uploading do not send messages or dial. Call tasks use `,_jsx(_components.code,{children:`options.agent_id`}),`. Every mutation requires `,_jsx(_components.code,{children:`batches:write`}),` for calls or `,_jsx(_components.code,{children:`sms:send`}),` for SMS. Reads require the corresponding `,_jsx(_components.code,{children:`batches:read`}),` or `,_jsx(_components.code,{children:`sms:read`}),`; having a scope for the other kind grants no access.`]}),`\n`,_jsx(Heading,{level:`2`,id:`upload-the-complete-recipient-list`,children:`Upload the complete recipient list`}),`\n`,_jsxs(_components.p,{children:[`Send `,_jsx(_components.code,{children:`PUT /bulk-tasks/{task_id}/chunks/{chunk_index}`}),` with `,_jsx(_components.code,{children:`{\"recipients\": [...]}`}),`. Indexes start at 0. Every chunk must contain exactly `,_jsx(_components.code,{children:`upload_chunk_size`}),` recipients, except the last chunk. For a call task using `,_jsx(_components.code,{children:`contact_ids`}),`, the array contains UUID strings. Otherwise it contains the existing inline call or SMS recipient objects.`]}),`\n`,_jsxs(_components.p,{children:[`Upload sequentially. An unchanged index and body is safe to retry with the same key, including after a timeout. Different content at an existing index returns `,_jsx(_components.code,{children:`409 idempotency_conflict`}),`. Duplicate phones, contact IDs and inline call external identities anywhere in a task reject the entire new chunk. The creating API key must perform uploads and start.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`9`,language:`javascript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`javascript`,children:_jsxs(_components.code,{language:`javascript`,numberOfLines:`9`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`// task is the create response; recipients is your complete local list.`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`for`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` (`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`let`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` offset`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 0`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`; `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`offset`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` \u003c`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` recipients`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#9CDCFE`},children:`length`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`; `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`offset`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` +=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` task`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`upload_chunk_size`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`) {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` index`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` offset`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` /`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` task`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`upload_chunk_size`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`;`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:` // uploadChunk wraps PUT /bulk-tasks/{task_id}/chunks/{chunk_index}.`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` response`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` uploadChunk`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`task`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`id`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`index`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` recipients:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` recipients`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`slice`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`offset`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`offset`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` +`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` task`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`upload_chunk_size`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`),`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }, { `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`idempotencyKey:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:\" `\"}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:\"${\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`task`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`id`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`-chunk-`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:\"${\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`index`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:\"`\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` });`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` if`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` (`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`!`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`response`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`ok`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`) `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`throw`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` new`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` Error`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:\"`Upload paused at chunk \"}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:\"${\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`index`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:\"${\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`response`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`status`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:\"`\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Each JSON request must fit the existing 1 MiB limit. Select a smaller `,_jsx(_components.code,{children:`upload_chunk_size`}),` (1–1,000) when recipient variables are large. If interrupted, resume using the same task, indexes, bodies and idempotency keys. Handle `,_jsx(_components.code,{children:`429`}),` using the `,_jsx(_components.a,{href:`/en/rate-limits`,children:`rate-limit response headers`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`start-background-execution`,children:`Start background execution`}),`\n`,_jsxs(_components.p,{children:[`Send `,_jsx(_components.code,{children:`POST /bulk-tasks/{task_id}/start`}),` with `,_jsx(_components.code,{children:`{}`}),` and an `,_jsx(_components.code,{children:`Idempotency-Key`}),`. An incomplete upload returns `,_jsx(_components.code,{children:`400 validation_error`}),` with `,_jsx(_components.code,{children:`upload_incomplete`}),`. Starting again is safe and never duplicates the task’s child batches.`]}),`\n`,_jsxs(Warning,{children:[`Starting a task authorizes real SMS sending or AI phone calls to its recipients, at its configured time. Use `,_jsx(_components.code,{children:`test_mode: true`}),` while integrating; it creates test results without carrier sends, dial commands or charges.`]}),`\n`,_jsx(_components.p,{children:`The scheduled worker prepares up to 10 SMS recipients or 100 call recipients per part, checking current key authority and destination rules. Revoked or expired keys prevent future parts from being submitted. The existing carrier, billing, call concurrency, calling-window and retry rules still apply. Large tasks may take multiple worker cycles; a requested schedule does not promise simultaneous delivery.`}),`\n`,_jsx(_components.p,{children:`Only one bulk call child per organization is active at a time, across all of its tasks, so a large task cannot fill the shared dialer shortlist. SMS preparation waits until its start time and pauses when the due delivery backlog reaches 500 recipients; this prevents mass preparation from outrunning the existing delivery worker and expiring unsent messages. Preparation runs on its own authenticated minute schedule with a 24-second cancellation deadline.`}),`\n`,_jsx(Heading,{level:`2`,id:`track-progress-and-investigate-failures`,children:`Track progress and investigate failures`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`GET /bulk-tasks/{task_id}`}),` reports `,_jsx(_components.code,{children:`uploaded_recipients`}),`, `,_jsx(_components.code,{children:`submitted_recipients`}),`, `,_jsx(_components.code,{children:`settled_recipients`}),`, `,_jsx(_components.code,{children:`failed_recipients`}),`, `,_jsx(_components.code,{children:`unknown_recipients`}),` and part counts. `,_jsx(_components.code,{children:`completed`}),` means every recipient has a settled result, including failures. It does not mean every SMS was delivered or every call was answered. Unknown SMS delivery remains unsettled; do not resend it in a new task.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`GET /bulk-tasks/{task_id}/parts`}),` returns at most 100 parts. Follow `,_jsx(_components.code,{children:`next_after`}),` using `,_jsx(_components.code,{children:`?after=...`}),`. Each submitted part includes `,_jsx(_components.code,{children:`batch_id`}),`, which uses the existing SMS or call batch query endpoints. Failed preparation parts include a fixed `,_jsx(_components.code,{children:`error_code`}),`; `,_jsx(_components.code,{children:`failed_recipients`}),` counts execution failures, while `,_jsx(_components.code,{children:`failed_parts`}),` identifies preparation failures that never submitted recipients.`]}),`\n`,_jsxs(_components.p,{children:[`Preparation failures make the task `,_jsx(_components.code,{children:`failed`}),`; previously submitted and other pending parts may continue. Task-wide cancellation and automatic replay of permanently failed parts are not provided. Use existing call batch pause/cancel endpoints for submitted call parts. Canonical contacts that resolve to the same person across call parts are rejected before that part starts. Never recreate the entire task to retry a partial or uncertain result.`]}),`\n`,_jsxs(_components.p,{children:[`The MCP equivalents are `,_jsx(_components.code,{children:`brightalk_create_bulk_task`}),`, `,_jsx(_components.code,{children:`brightalk_upload_bulk_task_chunk`}),`, `,_jsx(_components.code,{children:`brightalk_start_bulk_task`}),`, `,_jsx(_components.code,{children:`brightalk_get_bulk_task`}),` and `,_jsx(_components.code,{children:`brightalk_list_bulk_task_parts`}),`.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Large SMS and call tasks","description":"Upload up to 100,000 recipients and track background execution as one task.","href":"/en/guides/large-tasks"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Create an upload-only task","slug":"create-an-upload-only-task","depth":2,"children":[]},{"title":"Upload the complete recipient list","slug":"upload-the-complete-recipient-list","depth":2,"children":[]},{"title":"Start background execution","slug":"start-background-execution","depth":2,"children":[]},{"title":"Track progress and investigate failures","slug":"track-progress-and-investigate-failures","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"brightalk","siteName":"Brightalk Developer Documentation","title":"Large SMS and call tasks - Brightalk Developer Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"zh-Hant":{"href":"/zh-Hant/guides/large-tasks","matchLevel":1},"en":{"href":"/en/guides/large-tasks","matchLevel":0}}},"lastModified":"2026-11-16T08:14:06.436Z","originalFileLocation":"en/guides/large-tasks.mdx","locale":"en"},"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=\"Upload up to 100,000 recipients and track background execution as one task.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Brightalk Developer Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/brightalk/Fk6_FSm97cZf69fo/_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/brightalk/Fk6_FSm97cZf69fo/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/brightalk/Fk6_FSm97cZf69fo/_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/brightalk/Fk6_FSm97cZf69fo/_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/brightalk/Fk6_FSm97cZf69fo/_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/brightalk/Fk6_FSm97cZf69fo/_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/brightalk/Fk6_FSm97cZf69fo/_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/brightalk/Fk6_FSm97cZf69fo/_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/brightalk/Fk6_FSm97cZf69fo/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Large SMS and call tasks - Brightalk Developer Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Upload up to 100,000 recipients and track background execution as one task.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Brightalk Developer Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.brightalk.ai/en/guides/large-tasks\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://brightalk.mintlify.site/_mintlify/api/og/v2?division=Guides\u0026amp;title=Large+SMS+and+call+tasks\u0026amp;description=Upload+up+to+100%2C000+recipients+and+track+background+execution+as+one+task.\u0026amp;theme=2d10219a3a6a2864613069f0\u0026amp;signature=ae3bafd9768218f952e5c6e4b167144d001ab7c31674e5876bd4418842501422\">\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=\"Large SMS and call tasks - Brightalk Developer Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Upload up to 100,000 recipients and track background execution as one task.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://brightalk.mintlify.site/_mintlify/api/og/v2?division=Guides\u0026amp;title=Large+SMS+and+call+tasks\u0026amp;description=Upload+up+to+100%2C000+recipients+and+track+background+execution+as+one+task.\u0026amp;theme=2d10219a3a6a2864613069f0\u0026amp;signature=ae3bafd9768218f952e5c6e4b167144d001ab7c31674e5876bd4418842501422\">\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/brightalk/Fk6_FSm97cZf69fo/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Brightalk Developer Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#141414\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.brightalk.ai/en/guides/large-tasks\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/en/guides/large-tasks.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.brightalk.ai/en/guides/large-tasks\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"zh-Hant\" href=\"https://docs.brightalk.ai/zh-Hant/guides/large-tasks\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.brightalk.ai/zh-Hant/guides/large-tasks\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.brightalk.ai/#organization\",\"name\":\"Brightalk Developer Documentation\",\"url\":\"https://docs.brightalk.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/brightalk/cNN7numzDpngkdaF/images/logo-dark.svg?fit=max\u0026auto=format\u0026n=cNN7numzDpngkdaF\u0026q=85\u0026s=a5c61d9f016336ae5b4e15fbbd7a861b\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.brightalk.ai#website\",\"name\":\"Brightalk Developer Documentation\",\"url\":\"https://docs.brightalk.ai\",\"publisher\":{\"@id\":\"https://docs.brightalk.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.brightalk.ai/en/guides/large-tasks#webpage\",\"url\":\"https://docs.brightalk.ai/en/guides/large-tasks\",\"name\":\"Large SMS and call tasks\",\"description\":\"Upload up to 100,000 recipients and track background execution as one task.\",\"dateModified\":\"2026-11-16T08:14:06.436Z\",\"isPartOf\":{\"@id\":\"https://docs.brightalk.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.brightalk.ai/en/guides/large-tasks#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.brightalk.ai/en/guides/large-tasks#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Guides\",\"item\":\"https://docs.brightalk.ai/en/guides/place-one-call\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Large SMS and call tasks\",\"item\":\"https://docs.brightalk.ai/en/guides/large-tasks\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.brightalk.ai/en/guides/large-tasks#article\",\"headline\":\"Large SMS and call tasks\",\"name\":\"Large SMS and call tasks\",\"description\":\"Upload up to 100,000 recipients and track background execution as one task.\",\"url\":\"https://docs.brightalk.ai/en/guides/large-tasks\",\"mainEntityOfPage\":{\"@id\":\"https://docs.brightalk.ai/en/guides/large-tasks#webpage\"},\"dateModified\":\"2026-11-16T08:14:06.436Z\",\"publisher\":{\"@id\":\"https://docs.brightalk.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.brightalk.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Brightalk Developer Documentation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Brightalk Developer Documentation\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/en/guides/large-tasks.md","siteName":"Brightalk Developer Documentation","nav":{"global":null,"languages":[{"language":"zh-Hant","default":true,"navbar":{"primary":{"type":"button","label":"API 設定","href":"https://www.brightalk.ai/settings/integrations/api"}},"pages":[{"title":"zh-Hant","href":"/zh-Hant/guides/large-tasks"}]},{"language":"en","navbar":{"primary":{"type":"button","label":"API settings","href":"https://www.brightalk.ai/settings/integrations/api"}},"groups":[{"group":"Get started","pages":[{"title":"Brightalk API introduction","href":"/en/introduction"},{"title":"Quickstart","href":"/en/quickstart"},{"title":"MCP","href":"/en/mcp"}]},{"group":"API fundamentals","pages":[{"title":"Authentication and scopes","href":"/en/authentication"},{"title":"Versioning","href":"/en/versioning"},{"title":"Idempotency","href":"/en/idempotency"},{"title":"Rate limits","href":"/en/rate-limits"},{"title":"Errors","href":"/en/errors"}]},{"group":"Core concepts","pages":[{"title":"Contacts","href":"/en/concepts/contacts"},{"title":"AI voice agents","href":"/en/concepts/agents"},{"title":"Calls","href":"/en/concepts/calls"},{"title":"Recordings","href":"/en/concepts/recordings"},{"title":"Batch dialing","href":"/en/concepts/batches"},{"title":"Automations","href":"/en/concepts/automations"},{"title":"Status lifecycles","href":"/en/concepts/status-lifecycle"}]},{"group":"Guides","pages":[{"title":"Place one AI call","href":"/en/guides/place-one-call"},{"title":"Retrieve call results","href":"/en/guides/retrieve-call-results"},{"title":"Download call recordings","href":"/en/guides/download-call-recordings"},{"title":"Create and start a batch","href":"/en/guides/create-start-batch"},{"title":"Create an Automation run","href":"/en/guides/run-automation"},{"title":"Send a LINE message","href":"/en/guides/send-line-message"},{"title":"Personalized phone and SMS notifications","description":"Reuse an agent for appointments, events, pickups and service follow-ups, with individual variables, signed callbacks and workflow reporting.","href":"/en/guides/personalized-notifications"},{"title":"Large SMS and call tasks","href":"/en/guides/large-tasks"}]},{"group":"Release information","pages":[{"title":"Availability","description":"Review Public API functionality and dashboard dependencies.","href":"/en/availability"},{"title":"Changelog","href":"/en/changelog"}]},{"group":"API reference","pages":[{"group":"LINE messages","pages":[{"title":"Send a LINE text message","deprecated":null,"version":null,"playground":"simple","openapi":"/openapi/openapi.yaml post /line-messages","href":"/en/api-reference/line-messages/send-a-line-text-message"},{"title":"Get a LINE send receipt","deprecated":null,"version":null,"playground":"interactive","openapi":"/openapi/openapi.yaml get /line-messages/{message_id}","href":"/en/api-reference/line-messages/get-a-line-send-receipt"}]},{"group":"Agents","pages":[{"title":"List eligible AI voice agents","deprecated":null,"version":null,"playground":"interactive","openapi":"/openapi/openapi.yaml get /agents","href":"/en/api-reference/agents/list-eligible-ai-voice-agents"}]},{"group":"Automations","pages":[{"title":"List Automations","deprecated":null,"version":null,"playground":"interactive","openapi":"/openapi/openapi.yaml get /automations","href":"/en/api-reference/automations/list-automations"}]},{"group":"Contacts","pages":[{"title":"List contacts","deprecated":null,"version":null,"playground":"interactive","openapi":"/openapi/openapi.yaml get /contacts","href":"/en/api-reference/contacts/list-contacts"},{"title":"Create or adopt a contact","deprecated":null,"version":null,"playground":"simple","openapi":"/openapi/openapi.yaml post /contacts","href":"/en/api-reference/contacts/create-or-adopt-a-contact"},{"title":"Retrieve a contact","deprecated":null,"version":null,"playground":"interactive","openapi":"/openapi/openapi.yaml get /contacts/{contact_id}","href":"/en/api-reference/contacts/retrieve-a-contact"},{"title":"Update a contact","deprecated":null,"version":null,"playground":"simple","openapi":"/openapi/openapi.yaml patch /contacts/{contact_id}","href":"/en/api-reference/contacts/update-a-contact"}]},{"group":"Calls","pages":[{"title":"List API-visible calls","deprecated":null,"version":null,"playground":"interactive","openapi":"/openapi/openapi.yaml get /calls","href":"/en/api-reference/calls/list-api-visible-calls"},{"title":"Queue one immediate AI call","deprecated":null,"version":null,"playground":"simple","openapi":"/openapi/openapi.yaml post /calls","href":"/en/api-reference/calls/queue-one-immediate-ai-call"},{"title":"Retrieve a call","deprecated":null,"version":null,"playground":"interactive","openapi":"/openapi/openapi.yaml get /calls/{call_id}","href":"/en/api-reference/calls/retrieve-a-call"},{"title":"Retrieve a call summary","deprecated":null,"version":null,"playground":"interactive","openapi":"/openapi/openapi.yaml get /calls/{call_id}/summary","href":"/en/api-reference/calls/retrieve-a-call-summary"},{"title":"Retrieve a call transcript","deprecated":null,"version":null,"playground":"interactive","openapi":"/openapi/openapi.yaml get /calls/{call_id}/transcript","href":"/en/api-reference/calls/retrieve-a-call-transcript"},{"title":"Cancel a call","deprecated":null,"version":null,"playground":"simple","openapi":"/openapi/openapi.yaml post /calls/{call_id}/cancel","href":"/en/api-reference/calls/cancel-a-call"}]},{"group":"Recordings","pages":[{"title":"List call recordings","deprecated":null,"version":null,"playground":"interactive","openapi":"/openapi/openapi.yaml get /recordings","href":"/en/api-reference/recordings/list-call-recordings"},{"title":"Retrieve a call recording","deprecated":null,"version":null,"playground":"interactive","openapi":"/openapi/openapi.yaml get /recordings/{recording_id}","href":"/en/api-reference/recordings/retrieve-a-call-recording"}]},{"group":"Batches","pages":[{"title":"List batches","deprecated":null,"version":null,"playground":"interactive","openapi":"/openapi/openapi.yaml get /batches","href":"/en/api-reference/batches/list-batches"},{"title":"Create a draft batch","deprecated":null,"version":null,"playground":"simple","openapi":"/openapi/openapi.yaml post /batches","href":"/en/api-reference/batches/create-a-draft-batch"},{"title":"Retrieve a batch","deprecated":null,"version":null,"playground":"interactive","openapi":"/openapi/openapi.yaml get /batches/{batch_id}","href":"/en/api-reference/batches/retrieve-a-batch"},{"title":"Start or schedule a draft batch","deprecated":null,"version":null,"playground":"simple","openapi":"/openapi/openapi.yaml post /batches/{batch_id}/start","href":"/en/api-reference/batches/start-or-schedule-a-draft-batch"},{"title":"Pause future batch dispatch","deprecated":null,"version":null,"playground":"simple","openapi":"/openapi/openapi.yaml post /batches/{batch_id}/pause","href":"/en/api-reference/batches/pause-future-batch-dispatch"},{"title":"Resume batch dispatch","deprecated":null,"version":null,"playground":"simple","openapi":"/openapi/openapi.yaml post /batches/{batch_id}/resume","href":"/en/api-reference/batches/resume-batch-dispatch"},{"title":"Cancel remaining batch work","deprecated":null,"version":null,"playground":"simple","openapi":"/openapi/openapi.yaml post /batches/{batch_id}/cancel","href":"/en/api-reference/batches/cancel-remaining-batch-work"},{"title":"Create a large task","deprecated":null,"version":null,"playground":"simple","openapi":"/openapi/openapi.yaml post /bulk-tasks","href":"/en/api-reference/batches/create-a-large-task"},{"title":"Get large-task progress","deprecated":null,"version":null,"playground":"interactive","openapi":"/openapi/openapi.yaml get /bulk-tasks/{task_id}","href":"/en/api-reference/batches/get-large-task-progress"},{"title":"Upload a recipient chunk","deprecated":null,"version":null,"playground":"simple","openapi":"/openapi/openapi.yaml put /bulk-tasks/{task_id}/chunks/{chunk_index}","href":"/en/api-reference/batches/upload-a-recipient-chunk"},{"title":"Start a large task","deprecated":null,"version":null,"playground":"simple","openapi":"/openapi/openapi.yaml post /bulk-tasks/{task_id}/start","href":"/en/api-reference/batches/start-a-large-task"},{"title":"List large-task parts","deprecated":null,"version":null,"playground":"interactive","openapi":"/openapi/openapi.yaml get /bulk-tasks/{task_id}/parts","href":"/en/api-reference/batches/list-large-task-parts"}]},{"group":"Automation runs","pages":[{"title":"List API-started Automation runs","deprecated":null,"version":null,"playground":"interactive","openapi":"/openapi/openapi.yaml get /automation-runs","href":"/en/api-reference/automation-runs/list-api-started-automation-runs"},{"title":"Create an Automation run","deprecated":null,"version":null,"playground":"simple","openapi":"/openapi/openapi.yaml post /automation-runs","href":"/en/api-reference/automation-runs/create-an-automation-run"},{"title":"Retrieve an Automation run","deprecated":null,"version":null,"playground":"interactive","openapi":"/openapi/openapi.yaml get /automation-runs/{run_id}","href":"/en/api-reference/automation-runs/retrieve-an-automation-run"},{"title":"Cancel an Automation run","deprecated":null,"version":null,"playground":"simple","openapi":"/openapi/openapi.yaml post /automation-runs/{run_id}/cancel","href":"/en/api-reference/automation-runs/cancel-an-automation-run"}]},{"group":"Integrations","pages":[{"title":"Usage grouped by execution metadata","deprecated":null,"version":null,"playground":"interactive","openapi":"/openapi/openapi.yaml get /usage","href":"/en/api-reference/integrations/usage-grouped-by-execution-metadata"},{"title":"Available caller IDs and shared line capacity","deprecated":null,"version":null,"playground":"interactive","openapi":"/openapi/openapi.yaml get /telephony","href":"/en/api-reference/integrations/available-caller-ids-and-shared-line-capacity"},{"title":"SMS credits and account capabilities","deprecated":null,"version":null,"playground":"interactive","openapi":"/openapi/openapi.yaml get /sms/account","href":"/en/api-reference/integrations/sms-credits-and-account-capabilities"},{"title":"Retrieve SMS delivery status","deprecated":null,"version":null,"playground":"interactive","openapi":"/openapi/openapi.yaml get /sms/{sms_id}","href":"/en/api-reference/integrations/retrieve-sms-delivery-status"},{"title":"Retrieve SMS batch status","deprecated":null,"version":null,"playground":"interactive","openapi":"/openapi/openapi.yaml get /sms-batches/{batch_id}","href":"/en/api-reference/integrations/retrieve-sms-batch-status"},{"title":"Retrieve callback delivery status","deprecated":null,"version":null,"playground":"interactive","openapi":"/openapi/openapi.yaml get /webhook-events/{event_id}","href":"/en/api-reference/integrations/retrieve-callback-delivery-status"},{"title":"Retry an exhausted callback","deprecated":null,"version":null,"playground":"simple","openapi":"/openapi/openapi.yaml post /webhook-events/{event_id}/retry","href":"/en/api-reference/integrations/retry-an-exhausted-callback"},{"title":"Schedule an SMS message","deprecated":null,"version":null,"playground":"simple","openapi":"/openapi/openapi.yaml post /sms","href":"/en/api-reference/integrations/schedule-an-sms-message"},{"title":"Schedule a batch of SMS messages","deprecated":null,"version":null,"playground":"simple","openapi":"/openapi/openapi.yaml post /sms-batches","href":"/en/api-reference/integrations/schedule-a-batch-of-sms-messages"}]}]}]}]},"basePath":"","title":"Large SMS and call tasks - Brightalk Developer Documentation","buildId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","deploymentId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","dynamics":[],"chunks":[]}