Purchase additional calls-per-second (CPS) or concurrent-call capacity for a Vobiz account.
POST https://api.vobiz.ai/api/v1/accounts/{auth_id}/channel-subscriptionsContent-Type: application/json
A successful request immediately debits the first month’s charge from the account balance. Preview the exact price and obtain customer confirmation before purchasing.
Authentication
Use one of these authentication methods:
Method
Headers
Account access token
Authorization: Bearer <ACCESS_TOKEN>
Account API credentials
X-Auth-ID: <AUTH_ID> and X-Auth-Token: <AUTH_TOKEN>
The authenticated account can purchase capacity only for its own auth_id. An administrator may act on behalf of another account.
Parameters
Path parameter
Field
Type
Required
Description
auth_id
string
Yes
Target account Auth ID, such as MA_XXXX.
Request body
Field
Type
Required
Description
resource_type
string
Yes
Capacity to purchase. Use concurrent_calls or cps.
quantity
integer
Yes
Capacity quantity. Must be from 1 through 10000; pricing-tier block and quantity rules also apply.
{"docsConfig":{"theme":"luma","$schema":"https://mintlify.com/docs.json","name":"Vobiz","colors":{"primary":"#E83C00","light":"#E86A00","dark":"#c93400"},"logo":{"light":"https://mintcdn.com/vobizai/cPP2drhQ7lKsmogc/logo/light.svg?fit=max\u0026auto=format\u0026n=cPP2drhQ7lKsmogc\u0026q=85\u0026s=8e1f6273f626f638f46d6df526d4775c","dark":"https://mintcdn.com/vobizai/cPP2drhQ7lKsmogc/logo/dark.svg?fit=max\u0026auto=format\u0026n=cPP2drhQ7lKsmogc\u0026q=85\u0026s=57b37e5694f01e6933c9ec02a871250a","href":"https://www.vobiz.ai/docs/introduction"},"favicon":"https://mintcdn.com/vobizai/BDRzOqCvIsC8CJvN/favicon.svg?fit=max\u0026auto=format\u0026n=BDRzOqCvIsC8CJvN\u0026q=85\u0026s=b38182f12bc6b0e3a5df2a8ae1474f83","api":{"openapi":["openapi.yaml","openapi-sms.yaml","openapi-whatsapp.yaml"],"playground":{"display":"interactive"},"examples":{"defaults":"required","languages":["curl","python","javascript"],"prefill":true},"mdx":{"auth":{"method":"key","name":"X-Auth-Token"},"server":"https://api.vobiz.ai"}},"appearance":{"default":"dark"},"background":{"decoration":"gradient"},"navbar":{"links":[{"href":"mailto:support@vobiz.ai","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://console.vobiz.ai"}},"footer":{"socials":{"x":"https://x.com/Vobiz_Ai","github":"https://github.com/vobiz-ai","linkedin":"https://linkedin.com/company/vobizai"}},"seo":{"metatags":{"canonical":"https://www.vobiz.ai/docs","og:site_name":"Vobiz Docs","og:type":"website","og:locale":"en_US","twitter:card":"summary_large_image","twitter:site":"@Vobiz_Ai","twitter:creator":"@Vobiz_Ai","theme-color":"#E83C00","color-scheme":"dark light","author":"Vobiz","publisher":"Vobiz","copyright":"Copyright 2025 Vobiz","reply-to":"support@vobiz.ai","robots":"index, follow","format-detection":"telephone=no","referrer":"origin-when-cross-origin","rating":"general","language":"en","category":"Technology","coverage":"Worldwide","distribution":"global","target":"all"},"indexing":"all"},"integrations":{"ga4":{"measurementId":"G-YD6M3FF3P4"}},"contextual":{"options":["copy","view","assistant","chatgpt","claude","perplexity","mcp","add-mcp","cursor","vscode"],"display":"header"},"thumbnails":{"appearance":"dark"},"markdown":{"schema":true},"styling":{"latex":true},"navigation":{"global":{"anchors":[{"anchor":"API Status","icon":"signal","href":"https://status.vobiz.ai"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"vobizai","hasAudioNarration":false,"actualSubdomain":"vobizai","customDomains":["www.vobiz.ai"],"gitSource":{"type":"github","owner":"vobiz-ai","repo":"mintlify-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":"","_id":"6ae8948acb9fa025302af88e"},"feedback":{"thumbs":true,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6b00db3c4dbe5d10f9185131","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"API Reference","count":386},{"language":"default","tag":"Voice \u0026 XML","count":119},{"language":"default","tag":"Documentation","count":99},{"language":"default","tag":"SMS \u0026 RCS","count":92},{"language":"default","tag":"Blogs","count":82},{"language":"default","tag":"Articles","count":80},{"language":"default","tag":"Integrations","count":79},{"language":"default","tag":"Examples \u0026 Tutorials","count":59},{"language":"default","tag":"Regular APIs","count":40},{"language":"default","tag":"SIP Trunking","count":32}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true,"deflection":{"enabled":true,"email":"support@vobiz.ai","showHelpButton":true}},"basePath":"/docs","hasChatPermissions":false,"hasWebMcpPermissions":true,"toggles":[],"googleFontsInlined":false},"customCss":[{"filePath":"custom.css","href":"/docs/_mintlify/custom/vobizai/c4c76a1b5bc930af/custom.css"}]}
{"page":{"pagePath":"account/channel-subscriptions","slug":"/account/channel-subscriptions","pageMetadata":{"openapi":"POST /api/v1/accounts/{auth_id}/channel-subscriptions","title":"Purchase CPS or concurrency capacity","sidebarTitle":"Purchase capacity","description":"Purchase recurring Vobiz CPS or concurrent-call capacity and activate a channel subscription that renews every 30 days.","keywords":["purchase Vobiz CPS","purchase concurrent calls","channel subscription API","increase CPS limit API","increase concurrency limit API","voice capacity subscription","telephony capacity purchase","Vobiz monthly channel cost","concurrent call subscription","CPS subscription"],"href":"/account/channel-subscriptions"},"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: \"Purchase recurring Vobiz CPS or concurrent-call capacity and activate a channel subscription that renews every 30 days.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Note,Tab,Table,Tabs,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Tab)_missingMdxReference(`Tab`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tabs)_missingMdxReference(`Tabs`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Purchase additional calls-per-second (CPS) or concurrent-call capacity for a Vobiz account.`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`http`,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:`http`,children:_jsxs(_components.code,{language:`http`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`POST`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` https://api.vobiz.ai/api/v1/accounts/{auth_id}/channel-subscriptions`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`Content-Type`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` application/json`})]}),`\n`]})})}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`A successful request immediately debits the first month’s charge from the account balance. `,_jsx(_components.a,{href:`/account/channel-pricing-preview`,children:`Preview the exact price`}),` and obtain customer confirmation before purchasing.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`authentication`,children:`Authentication`}),`\n`,_jsx(_components.p,{children:`Use one of these authentication methods:`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Method`}),_jsx(_components.th,{children:`Headers`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Account access token`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`Authorization: Bearer \u003cACCESS_TOKEN>`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Account API credentials`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`X-Auth-ID: \u003cAUTH_ID>`}),` and `,_jsx(_components.code,{children:`X-Auth-Token: \u003cAUTH_TOKEN>`})]})]})]})]}),`\n`,_jsxs(_components.p,{children:[`The authenticated account can purchase capacity only for its own `,_jsx(_components.code,{children:`auth_id`}),`. An administrator may act on behalf of another account.`]}),`\n`,_jsx(Heading,{level:`2`,id:`parameters`,children:`Parameters`}),`\n`,_jsx(Heading,{level:`3`,id:`path-parameter`,children:`Path parameter`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Required`}),_jsx(_components.th,{children:`Description`})]})}),_jsx(_components.tbody,{children:_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`auth_id`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Yes`}),_jsxs(_components.td,{children:[`Target account Auth ID, such as `,_jsx(_components.code,{children:`MA_XXXX`}),`.`]})]})})]}),`\n`,_jsx(Heading,{level:`3`,id:`request-body`,children:`Request body`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Required`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`resource_type`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Yes`}),_jsxs(_components.td,{children:[`Capacity to purchase. Use `,_jsx(_components.code,{children:`concurrent_calls`}),` or `,_jsx(_components.code,{children:`cps`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`quantity`})}),_jsx(_components.td,{children:`integer`}),_jsx(_components.td,{children:`Yes`}),_jsxs(_components.td,{children:[`Capacity quantity. Must be from `,_jsx(_components.code,{children:`1`}),` through `,_jsx(_components.code,{children:`10000`}),`; pricing-tier block and quantity rules also apply.`]})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`examples`,children:`Examples`}),`\n`,_jsxs(Tabs,{children:[_jsx(Tab,{title:`Concurrent calls`,id:`concurrent-calls`,children:_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`9`,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:`9`,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:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.vobiz.ai/api/v1/accounts/MA_XXXX/channel-subscriptions\"`}),_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-Auth-ID: MA_XXXX\"`}),_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-Auth-Token: YOUR_AUTH_TOKEN\"`}),_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:` \"resource_type\": \"concurrent_calls\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"quantity\": 30`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})})}),_jsx(Tab,{title:`CPS`,id:`cps`,children:_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`9`,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:`9`,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:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.vobiz.ai/api/v1/accounts/MA_XXXX/channel-subscriptions\"`}),_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-Auth-ID: MA_XXXX\"`}),_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-Auth-Token: YOUR_AUTH_TOKEN\"`}),_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:` \"resource_type\": \"cps\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"quantity\": 10`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})})})]}),`\n`,_jsx(Heading,{level:`2`,id:`successful-response`,children:`Successful response`}),`\n`,_jsx(_components.p,{children:`The values below are illustrative. The actual monthly cost, currency, and billing dates come from the account and its assigned pricing tier.`}),`\n`,_jsx(CodeBlock,{filename:`Subscription activated`,numberOfLines:`17`,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:`17`,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:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"5ed57f90-b1f1-4c32-9475-b85aa6739aec\"`}),_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:` \"account_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`123456`}),_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:` \"resource_type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"concurrent_calls\"`}),_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:` \"quantity\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`30`}),_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:` \"monthly_cost\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"10470.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:` \"currency\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"INR\"`}),_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:`\"active\"`}),_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:` \"last_billing_date\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-07-16T10:00:00Z\"`}),_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:` \"next_billing_date\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-08-15T10:00:00Z\"`}),_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:` \"purchased_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-07-16T10:00:00Z\"`}),_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:` \"cancelled_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_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:` \"cancellation_reason\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_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:` \"is_active\"`}),_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`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"created_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-07-16T10:00:00Z\"`}),_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:` \"updated_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-07-16T10:00:00Z\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`id`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Unique subscription identifier.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`account_id`})}),_jsx(_components.td,{children:`integer`}),_jsx(_components.td,{children:`Internal identifier of the account that owns the subscription.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`resource_type`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Purchased capacity type.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`quantity`})}),_jsx(_components.td,{children:`integer`}),_jsx(_components.td,{children:`Purchased capacity quantity.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`monthly_cost`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Recurring monthly charge as a decimal string.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`currency`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Billing currency from the account’s pricing tier.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`status`})}),_jsx(_components.td,{children:`string`}),_jsxs(_components.td,{children:[`Subscription status. A successful purchase is created as `,_jsx(_components.code,{children:`active`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`last_billing_date`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Date and time of the most recent subscription charge.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`next_billing_date`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Scheduled date and time of the next charge.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`purchased_at`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Date and time the capacity was purchased.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`cancelled_at`})}),_jsx(_components.td,{children:`string or null`}),_jsx(_components.td,{children:`Date and time the subscription was cancelled, if applicable.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`cancellation_reason`})}),_jsx(_components.td,{children:`string or null`}),_jsx(_components.td,{children:`Recorded cancellation reason, if applicable.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`is_active`})}),_jsx(_components.td,{children:`boolean`}),_jsx(_components.td,{children:`Whether the subscription is currently active.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`created_at`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Date and time the subscription record was created.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`updated_at`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Date and time the subscription record was last updated.`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`billing-and-validation`,children:`Billing and validation`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`resource_type`}),` must be `,_jsx(_components.code,{children:`concurrent_calls`}),` or `,_jsx(_components.code,{children:`cps`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`quantity`}),` must be an integer from `,_jsx(_components.code,{children:`1`}),` through `,_jsx(_components.code,{children:`10000`}),`.`]}),`\n`,_jsx(_components.li,{children:`Pricing uses the account’s assigned pricing tier and applicable pricing brackets.`}),`\n`,_jsx(_components.li,{children:`The tier’s block-size, minimum-quantity, and maximum-quantity rules are enforced.`}),`\n`,_jsx(_components.li,{children:`A successful purchase immediately debits the first month’s charge.`}),`\n`,_jsx(_components.li,{children:`The subscription is created as active and scheduled to renew every 30 days.`}),`\n`,_jsx(_components.li,{children:`The purchase fails if the account has no pricing tier, the quantity violates its pricing rules, or the balance debit fails.`}),`\n`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Do not automatically retry a timed-out purchase. First `,_jsx(_components.a,{href:`/account/retrieve-account`,children:`retrieve the account`}),` and `,_jsx(_components.a,{href:`/account/balance`,children:`check its balance`}),` to avoid a duplicate charge.`]})})]})}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":{"openapi":"POST /api/v1/accounts/{auth_id}/channel-subscriptions","title":"Purchase CPS or concurrency capacity","sidebarTitle":"Purchase capacity","description":"Purchase recurring Vobiz CPS or concurrent-call capacity and activate a channel subscription that renews every 30 days.","keywords":["purchase Vobiz CPS","purchase concurrent calls","channel subscription API","increase CPS limit API","increase concurrency limit API","voice capacity subscription","telephony capacity purchase","Vobiz monthly channel cost","concurrent call subscription","CPS subscription"],"href":"/account/channel-subscriptions"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Authentication","slug":"authentication","depth":2,"children":[]},{"title":"Parameters","slug":"parameters","depth":2,"children":[{"title":"Path parameter","slug":"path-parameter","depth":3,"children":[]},{"title":"Request body","slug":"request-body","depth":3,"children":[]}]},{"title":"Examples","slug":"examples","depth":2,"children":[]},{"title":"Successful response","slug":"successful-response","depth":2,"children":[]},{"title":"Billing and validation","slug":"billing-and-validation","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/docs/_mintlify/custom/vobizai/478834ae2c200a0e/blog-schema.js","/docs/_mintlify/custom/vobizai/13b0cd7ec6e39877/anchor-link-text.js"],"openApiReferenceData":{"operation":{"operationId":"create-channel-subscription","summary":"Purchase CPS or concurrency capacity","description":"Purchase recurring Vobiz CPS or concurrent-call capacity and activate a channel subscription that renews every 30 days.","tags":["Account"],"security":["4994c9a2-3d2a-4353-8e94-1930e33b22b4","8afa60e8-cd91-4c68-89ea-540c96a7c7d9"],"parameters":["ef71e0f8-f756-4eac-b31d-4268ea655e19"],"requestBody":"59c2a945-6ee0-494d-bcf5-328dd57b3530","responses":{"201":"03b63de8-2947-4665-9447-3fc2cb49ba88","400":"0b429551-d011-469a-b679-0208f3da3343","401":"ca517f12-1138-4c97-987c-1d091b795541","403":"3dd4a551-cf26-4052-bc2c-7b50ff24246a"},"method":"post","type":"path","servers":["63df1293-34a2-4314-96e6-4cfcad0f4404"],"path":"/api/v1/accounts/{auth_id}/channel-subscriptions","baseUrlOptions":["https://api.vobiz.ai"],"title":"Purchase CPS or concurrency capacity","codeSamples":[],"requestExampleLanguages":["bash","python","javascript"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[{"body.resource_type":"concurrent_calls","body.quantity":30}]},"dependencies":{"parameters":{"ef71e0f8-f756-4eac-b31d-4268ea655e19":{"name":"auth_id","in":"path","required":true,"description":"Target account Auth ID. An account can purchase only for itself; administrators may act for another account.","schema":{"type":"string","example":"MA_XXXX","isRequired":true,"description":"Target account Auth ID. An account can purchase only for itself; administrators may act for another account.","uniqueKey":"","typeLabel":"string"}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["resource_type","quantity"],"properties":{"resource_type":{"type":"string","description":"Account capacity to price or purchase.","enum":["concurrent_calls","cps"],"example":"concurrent_calls","isRequired":true,"uniqueKey":"resource_type","typeLabel":"enum\u003cstring>"},"quantity":{"type":"integer","minimum":1,"maximum":10000,"description":"Capacity quantity to purchase. Pricing-tier block and quantity rules also apply.","example":30,"isRequired":true,"uniqueKey":"quantity","typeLabel":"integer"}},"uniqueKey":"","typeLabel":"object"},"example":{"resource_type":"concurrent_calls","quantity":30},"examples":{"Example":{"title":"Example","value":{"resource_type":"concurrent_calls","quantity":30}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"03b63de8-2947-4665-9447-3fc2cb49ba88":{"description":"Capacity subscription purchased and activated.","content":{"application/json":{"schema":{"type":"object","required":["id","account_id","resource_type","quantity","monthly_cost","currency","status","last_billing_date","next_billing_date","purchased_at","cancelled_at","cancellation_reason","is_active","created_at","updated_at"],"properties":{"id":{"type":"string","format":"uuid","example":"5ed57f90-b1f1-4c32-9475-b85aa6739aec","isRequired":true,"uniqueKey":"id","typeLabel":"string\u003cuuid>"},"account_id":{"type":"integer","example":123456,"isRequired":true,"uniqueKey":"account_id","typeLabel":"integer"},"resource_type":{"type":"string","description":"Account capacity to price or purchase.","enum":["concurrent_calls","cps"],"example":"concurrent_calls","isRequired":true,"uniqueKey":"resource_type","typeLabel":"enum\u003cstring>"},"quantity":{"type":"integer","minimum":1,"maximum":10000,"example":30,"isRequired":true,"uniqueKey":"quantity","typeLabel":"integer"},"monthly_cost":{"type":"string","description":"Recurring monthly charge as a decimal string.","example":"10470.00","isRequired":true,"uniqueKey":"monthly_cost","typeLabel":"string"},"currency":{"type":"string","example":"INR","isRequired":true,"uniqueKey":"currency","typeLabel":"string"},"status":{"type":"string","example":"active","isRequired":true,"uniqueKey":"status","typeLabel":"string"},"last_billing_date":{"type":"string","format":"date-time","example":"2026-07-16T10:00:00Z","isRequired":true,"uniqueKey":"last_billing_date","typeLabel":"string\u003cdate-time>"},"next_billing_date":{"type":"string","format":"date-time","example":"2026-08-15T10:00:00Z","isRequired":true,"uniqueKey":"next_billing_date","typeLabel":"string\u003cdate-time>"},"purchased_at":{"type":"string","format":"date-time","example":"2026-07-16T10:00:00Z","isRequired":true,"uniqueKey":"purchased_at","typeLabel":"string\u003cdate-time>"},"cancelled_at":{"oneOf":[{"type":"string","format":"date-time","example":null,"isRequired":true,"uniqueKey":"cancelled_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","example":null,"isRequired":true,"uniqueKey":"cancelled_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"cancelled_at","typeLabel":"string\u003cdate-time> | null"},"cancellation_reason":{"oneOf":[{"type":"string","example":null,"isRequired":true,"uniqueKey":"cancellation_reason.oneOf.0","typeLabel":"string"},{"type":"null","example":null,"isRequired":true,"uniqueKey":"cancellation_reason.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"cancellation_reason","typeLabel":"string | null"},"is_active":{"type":"boolean","example":true,"isRequired":true,"uniqueKey":"is_active","typeLabel":"boolean"},"created_at":{"type":"string","format":"date-time","example":"2026-07-16T10:00:00Z","isRequired":true,"uniqueKey":"created_at","typeLabel":"string\u003cdate-time>"},"updated_at":{"type":"string","format":"date-time","example":"2026-07-16T10:00:00Z","isRequired":true,"uniqueKey":"updated_at","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"","typeLabel":"object"},"example":{"id":"5ed57f90-b1f1-4c32-9475-b85aa6739aec","account_id":123456,"resource_type":"concurrent_calls","quantity":30,"monthly_cost":"10470.00","currency":"INR","status":"active","last_billing_date":"2026-07-16T10:00:00Z","next_billing_date":"2026-08-15T10:00:00Z","purchased_at":"2026-07-16T10:00:00Z","cancelled_at":null,"cancellation_reason":null,"is_active":true,"created_at":"2026-07-16T10:00:00Z","updated_at":"2026-07-16T10:00:00Z"},"examples":{"Example":{"title":"Example","value":{"id":"5ed57f90-b1f1-4c32-9475-b85aa6739aec","account_id":123456,"resource_type":"concurrent_calls","quantity":30,"monthly_cost":"10470.00","currency":"INR","status":"active","last_billing_date":"2026-07-16T10:00:00Z","next_billing_date":"2026-08-15T10:00:00Z","purchased_at":"2026-07-16T10:00:00Z","cancelled_at":null,"cancellation_reason":null,"is_active":true,"created_at":"2026-07-16T10:00:00Z","updated_at":"2026-07-16T10:00:00Z"}}},"exampleType":"examples"}},"exampleType":"examples"},"0b429551-d011-469a-b679-0208f3da3343":{"description":"The purchase could not be completed because validation, pricing-tier, or account-balance requirements were not met.","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"ca517f12-1138-4c97-987c-1d091b795541":{"description":"Missing or invalid authentication.","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"3dd4a551-cf26-4052-bc2c-7b50ff24246a":{"description":"The authenticated account cannot act on the target account.","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{"4994c9a2-3d2a-4353-8e94-1930e33b22b4":{"BearerAuth":{"type":"http","scheme":"bearer","description":"Account access token sent as `Authorization: Bearer \u003cACCESS_TOKEN>`.","scopes":[],"schemeName":"BearerAuth"}},"8afa60e8-cd91-4c68-89ea-540c96a7c7d9":{"AuthID":{"type":"apiKey","in":"header","name":"X-Auth-ID","description":"Your Vobiz account Auth ID","scopes":[],"schemeName":"AuthID"},"AuthToken":{"type":"apiKey","in":"header","name":"X-Auth-Token","description":"Your Vobiz account Auth Token","scopes":[],"schemeName":"AuthToken"}}},"servers":{"63df1293-34a2-4314-96e6-4cfcad0f4404":{"url":"https://api.vobiz.ai","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Account access token sent as `Authorization: Bearer \u003cACCESS_TOKEN>`.","scopes":[],"schemeName":"BearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Account access token sent as `Authorization: Bearer \u003cACCESS_TOKEN>`.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"BearerAuth","name":"Authorization"}],"title":"BearerAuth"},{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-Auth-ID","description":"Your Vobiz account Auth ID","scopes":[],"schemeName":"AuthID"},"schema":{"title":"X-Auth-ID","type":"string","description":"Your Vobiz account Auth ID","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"AuthID","name":"X-Auth-ID"},{"scheme":{"type":"apiKey","in":"header","name":"X-Auth-Token","description":"Your Vobiz account Auth Token","scopes":[],"schemeName":"AuthToken"},"schema":{"title":"X-Auth-Token","type":"string","description":"Your Vobiz account Auth Token","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"AuthToken","name":"X-Auth-Token"}],"title":"AuthID \u0026 AuthToken"}]},"originalFileLocation":"openapi.yaml"},"subdomain":"vobizai","siteName":"Vobiz","title":"Purchase CPS or concurrency capacity - Vobiz","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-18T20:13:57.298Z","originalFileLocation":"account/channel-subscriptions.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=\"Purchase recurring Vobiz CPS or concurrent-call capacity and activate a channel subscription that renews every 30 days.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Vobiz\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003cmeta data-mint-head name=\"robots\" content=\"index, follow\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/vobizai/oc0LWA8xGPKGY1Z5/_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=\"/docs/mintlify-assets/_mintlify/favicons/vobizai/oc0LWA8xGPKGY1Z5/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/vobizai/oc0LWA8xGPKGY1Z5/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/vobizai/oc0LWA8xGPKGY1Z5/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/vobizai/oc0LWA8xGPKGY1Z5/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/vobizai/oc0LWA8xGPKGY1Z5/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/vobizai/oc0LWA8xGPKGY1Z5/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/vobizai/oc0LWA8xGPKGY1Z5/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/vobizai/oc0LWA8xGPKGY1Z5/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Purchase CPS or concurrency capacity - Vobiz\">\u003cmeta data-mint-head property=\"og:description\" content=\"Purchase recurring Vobiz CPS or concurrent-call capacity and activate a channel subscription that renews every 30 days.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Vobiz Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://www.vobiz.ai/docs/account/channel-subscriptions\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://vobizai.mintlify.site/docs/_mintlify/api/og/v2?division=Account\u0026amp;title=Purchase+CPS+or+concurrency+capacity\u0026amp;description=Purchase+recurring+Vobiz+CPS+or+concurrent-call+capacity+and+activate+a+channel+subscription+that+renews+every+30+days.\u0026amp;theme=d9cfb5a257c4db351c1c1eeb\u0026amp;signature=291eec2a19d91175ce7c62116bebfeace4ea5758fc166fc0d7b06d228d0f979b\">\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=\"Purchase CPS or concurrency capacity - Vobiz\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Purchase recurring Vobiz CPS or concurrent-call capacity and activate a channel subscription that renews every 30 days.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://vobizai.mintlify.site/docs/_mintlify/api/og/v2?division=Account\u0026amp;title=Purchase+CPS+or+concurrency+capacity\u0026amp;description=Purchase+recurring+Vobiz+CPS+or+concurrent-call+capacity+and+activate+a+channel+subscription+that+renews+every+30+days.\u0026amp;theme=d9cfb5a257c4db351c1c1eeb\u0026amp;signature=291eec2a19d91175ce7c62116bebfeace4ea5758fc166fc0d7b06d228d0f979b\">\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=\"/docs/mintlify-assets/_mintlify/favicons/vobizai/oc0LWA8xGPKGY1Z5/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Vobiz\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#E83C00\">\u003cmeta data-mint-head name=\"og:locale\" content=\"en_US\">\u003cmeta data-mint-head name=\"twitter:creator\" content=\"@Vobiz_Ai\">\u003cmeta data-mint-head name=\"theme-color\" content=\"#E83C00\">\u003cmeta data-mint-head name=\"color-scheme\" content=\"dark light\">\u003cmeta data-mint-head name=\"author\" content=\"Vobiz\">\u003cmeta data-mint-head name=\"publisher\" content=\"Vobiz\">\u003cmeta data-mint-head name=\"copyright\" content=\"Copyright 2025 Vobiz\">\u003cmeta data-mint-head name=\"reply-to\" content=\"support@vobiz.ai\">\u003cmeta data-mint-head name=\"format-detection\" content=\"telephone=no\">\u003cmeta data-mint-head name=\"referrer\" content=\"origin-when-cross-origin\">\u003cmeta data-mint-head name=\"rating\" content=\"general\">\u003cmeta data-mint-head name=\"language\" content=\"en\">\u003cmeta data-mint-head name=\"category\" content=\"Technology\">\u003cmeta data-mint-head name=\"coverage\" content=\"Worldwide\">\u003cmeta data-mint-head name=\"distribution\" content=\"global\">\u003cmeta data-mint-head name=\"target\" content=\"all\">\u003clink data-mint-head rel=\"canonical\" href=\"https://www.vobiz.ai/docs/account/channel-subscriptions\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/account/channel-subscriptions.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://www.vobiz.ai/#organization\",\"name\":\"Vobiz\",\"url\":\"https://www.vobiz.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/vobizai/cPP2drhQ7lKsmogc/logo/light.svg?fit=max\u0026auto=format\u0026n=cPP2drhQ7lKsmogc\u0026q=85\u0026s=8e1f6273f626f638f46d6df526d4775c\"}},{\"@type\":\"WebSite\",\"@id\":\"https://www.vobiz.ai/docs#website\",\"name\":\"Vobiz\",\"url\":\"https://www.vobiz.ai/docs\",\"publisher\":{\"@id\":\"https://www.vobiz.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://www.vobiz.ai/docs/account/channel-subscriptions#webpage\",\"url\":\"https://www.vobiz.ai/docs/account/channel-subscriptions\",\"name\":\"Purchase CPS or concurrency capacity\",\"description\":\"Purchase recurring Vobiz CPS or concurrent-call capacity and activate a channel subscription that renews every 30 days.\",\"dateModified\":\"2026-11-18T20:13:57.298Z\",\"isPartOf\":{\"@id\":\"https://www.vobiz.ai/docs#website\"},\"breadcrumb\":{\"@id\":\"https://www.vobiz.ai/docs/account/channel-subscriptions#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://www.vobiz.ai/docs/account/channel-subscriptions#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Account\",\"item\":\"https://www.vobiz.ai/docs/account\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Purchase CPS or concurrency capacity\",\"item\":\"https://www.vobiz.ai/docs/account/channel-subscriptions\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://www.vobiz.ai/docs/account/channel-subscriptions#apireference\",\"headline\":\"Purchase CPS or concurrency capacity\",\"name\":\"Purchase CPS or concurrency capacity\",\"description\":\"Purchase recurring Vobiz CPS or concurrent-call capacity and activate a channel subscription that renews every 30 days.\",\"url\":\"https://www.vobiz.ai/docs/account/channel-subscriptions\",\"mainEntityOfPage\":{\"@id\":\"https://www.vobiz.ai/docs/account/channel-subscriptions#webpage\"},\"dateModified\":\"2026-11-18T20:13:57.298Z\",\"keywords\":\"purchase Vobiz CPS, purchase concurrent calls, channel subscription API, increase CPS limit API, increase concurrency limit API, voice capacity subscription, telephony capacity purchase, Vobiz monthly channel cost, concurrent call subscription, CPS subscription\",\"publisher\":{\"@id\":\"https://www.vobiz.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://www.vobiz.ai/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Vobiz\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Vobiz\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/account/channel-subscriptions.md","siteName":"Vobiz","nav":{"global":{"anchors":[{"anchor":"API Status","icon":"signal","href":"https://status.vobiz.ai"}]},"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"API Reference","anchors":[{"anchor":"Regular APIs","icon":"database","groups":[{"group":"Account","boost":3,"icon":"circle-user","root":{"title":"Vobiz Account API: Balance \u0026 Concurrency","sidebarTitle":"Account","href":"/account"},"pages":[{"title":"The Account Object","href":"/account/account-object"},{"openapi":"GET /api/v1/auth/me","title":"Retrieve Account Details","href":"/account/retrieve-account"},{"openapi":"GET /api/v1/Account/{auth_id}/balance/{currency}","title":"Balance","href":"/account/balance"},{"openapi":"GET /api/v1/Account/{auth_id}/transactions","title":"Transactions","href":"/account/transactions"},{"openapi":"GET /api/v1/Account/{auth_id}/concurrency","title":"Get Account Concurrency — Live Call Capacity","sidebarTitle":"Concurrency","href":"/account/concurrency"},{"openapi":"GET /api/v1/accounts/{auth_id}/channel-pricing-preview","title":"Preview CPS and concurrency pricing","sidebarTitle":"Preview capacity pricing","description":"Calculate the monthly price for additional Vobiz CPS or concurrent-call capacity without purchasing capacity or debiting the account.","href":"/account/channel-pricing-preview"},{"openapi":"POST /api/v1/accounts/{auth_id}/channel-subscriptions","title":"Purchase CPS or concurrency capacity","sidebarTitle":"Purchase capacity","href":"/account/channel-subscriptions"},{"title":"NDNC Webhook","description":"Receive real-time UCC / NDNC complaint alerts on your HTTPS endpoint. Send your URL and shared secret to ndnc@vobiz.ai, then verify X-Vobiz-Signature.","sidebarTitle":"NDNC Webhook","href":"/account/ndnc-webhook"}]},{"group":"Sub-Accounts","icon":"sitemap","root":{"title":"Vobiz Sub-Accounts API: Multi-Tenant Accounts","sidebarTitle":"Sub-Accounts","href":"/sub-accounts"},"pages":[{"title":"Sub-Account Onboarding Flow","sidebarTitle":"Onboarding Flow","href":"/sub-accounts/onboarding-flow"},{"title":"The Subaccount Object","sidebarTitle":"Subaccount Object","href":"/sub-accounts/subaccount-object"},{"openapi":"POST /api/v1/accounts/{auth_id}/sub-accounts/","title":"Create a Subaccount","sidebarTitle":"Create Subaccount","href":"/sub-accounts/create-subaccount"},{"openapi":"GET /api/v1/accounts/{auth_id}/sub-accounts/{sub_auth_id}","title":"Retrieve a Subaccount","sidebarTitle":"Retrieve Subaccount","href":"/sub-accounts/retrieve-subaccount"},{"openapi":"PUT /api/v1/accounts/{auth_id}/sub-accounts/{sub_auth_id}","title":"Update a Subaccount","sidebarTitle":"Update Subaccount","href":"/sub-accounts/update-subaccount"},{"openapi":"DELETE /api/v1/accounts/{auth_id}/sub-accounts/{sub_auth_id}","title":"Delete a Subaccount","sidebarTitle":"Delete Subaccount","href":"/sub-accounts/delete-subaccount"},{"openapi":"GET /api/v1/accounts/{auth_id}/sub-accounts/","title":"List All Subaccounts","sidebarTitle":"List Subaccounts","href":"/sub-accounts/list-all-subaccounts"},{"openapi":"POST /api/v1/account/{auth_id}/numbers/{e164}/assign-subaccount","title":"Assign DID to Sub-Account","sidebarTitle":"Assign to Sub-Account","href":"/account-phone-number/assign-subaccount"},{"openapi":"DELETE /api/v1/account/{auth_id}/numbers/{e164}/assign-subaccount","title":"Unassign DID (15-Day Cool-Off)","sidebarTitle":"Unassign from Sub-Account","href":"/account-phone-number/unassign-subaccount"},{"group":"KYC","icon":"id-card","pages":[{"title":"Sub-Account KYC","sidebarTitle":"Overview","href":"/sub-accounts/kyc/overview"},{"openapi":"GET /api/v1/sub-accounts/{sub_auth_id}/kyc/status","title":"Get KYC Status","sidebarTitle":"KYC Status","href":"/sub-accounts/kyc/kyc-status"},{"openapi":"POST /api/v1/sub-accounts/{sub_auth_id}/kyc-sessions","title":"Initialize KYC","sidebarTitle":"Initialize KYC","href":"/sub-accounts/kyc/kyc-session"},{"title":"KYC Email Flow with Webhook","sidebarTitle":"Email Flow \u0026 Webhook","href":"/sub-accounts/kyc/email-flow-webhook"},{"title":"KYC Redirect Flow with Webhook","sidebarTitle":"Redirect Flow \u0026 Webhook","href":"/sub-accounts/kyc/redirect-flow-webhook"},{"title":"KYC Test Mode","sidebarTitle":"Test Mode","href":"/sub-accounts/kyc/test-mode"}]}]},{"group":"Phone Numbers","icon":"phone","root":{"title":"Vobiz Phone Numbers API: Buy \u0026 Manage DIDs","sidebarTitle":"Phone Numbers","href":"/account-phone-number"},"pages":[{"title":"The PhoneNumber Object","sidebarTitle":"PhoneNumber Object","href":"/account-phone-number/account-phone-number-object"},{"openapi":"GET /api/v1/Account/{auth_id}/numbers","title":"List Account Phone Numbers","href":"/account-phone-number/list-account-phone-numbers"},{"title":"List Inventory Numbers","sidebarTitle":"List Inventory","openapi":"GET /api/v1/Account/{auth_id}/inventory/numbers","href":"/account-phone-number/list-inventory-numbers"},{"title":"Purchase from Inventory","sidebarTitle":"Purchase Number","openapi":"POST /api/v1/Account/{auth_id}/numbers/purchase-from-inventory","href":"/account-phone-number/purchase-from-inventory"},{"openapi":"DELETE /api/v1/Account/{auth_id}/numbers/{e164}","title":"Release a Phone Number","href":"/account-phone-number/unrent-number"},{"openapi":"POST /api/v1/account/{account_id}/numbers/{e164}/cancel-release","title":"Cancel a Number Release","sidebarTitle":"Cancel Release","href":"/account-phone-number/cancel-release"},{"openapi":"GET /api/v1/account/{auth_id}/numbers/{e164}/health","title":"Get Number Health Dashboard","sidebarTitle":"Number Health","href":"/account-phone-number/get-number-health"}]},{"group":"Recordings","icon":"circle-dot","root":{"title":"Vobiz Recordings API: Call \u0026 Conference Recordings","sidebarTitle":"Recording","href":"/recording"},"pages":[{"title":"The Recording Object","href":"/recording/recording-object"},{"openapi":"GET /api/v1/Account/{auth_id}/Recording/{recording_id}/","title":"Retrieve a Recording","href":"/recording/retrieve-recording"},{"openapi":"GET /api/v1/Account/{auth_id}/Recording/","title":"List All Recordings","href":"/recording/list-all-recordings"},{"title":"Download a Recording","href":"/recording/download-recording"},{"openapi":"POST /api/v1/Account/{auth_id}/export/recording/","title":"Export Historical Recordings","sidebarTitle":"Export Recordings","href":"/recording/export-historical-recordings"}]},{"group":"Call Detail Records","icon":"list-ul","root":{"title":"Vobiz Call Detail Records (CDR) API","sidebarTitle":"Call Detail Records","href":"/cdr"},"pages":[{"title":"List CDRs","openapi":"GET /api/v1/Account/{auth_id}/cdr","href":"/cdr/list-cdrs"},{"title":"Get Single CDR","openapi":"GET /api/v1/Account/{auth_id}/cdr/{call_id}","href":"/cdr/get-cdr"},{"title":"Search CDRs","openapi":"GET /api/v1/Account/{auth_id}/cdr/search","href":"/cdr/search-cdrs"},{"title":"Recent CDRs","openapi":"GET /api/v1/Account/{auth_id}/cdr/recent","href":"/cdr/recent-cdrs"},{"title":"Export CDRs as CSV","openapi":"GET /api/v1/Account/{auth_id}/cdr/export","href":"/cdr/export-cdrs"}]}]},{"anchor":"SIP Trunking","icon":"network-wired","pages":[{"title":"SIP Trunking","href":"/trunks"}]},{"anchor":"Voice \u0026 XML","icon":"microphone","pages":[{"title":"Voice \u0026 XML","href":"/applications"}]},{"anchor":"SMS \u0026 RCS","icon":"comment-sms","pages":[{"title":"SMS \u0026 RCS","href":"/sms/overview"}]},{"anchor":"WhatsApp","icon":"comment-dots","pages":[{"title":"WhatsApp","href":"/whatsapp/getting-started/introduction"}]},{"anchor":"Partner API","icon":"handshake","pages":[{"title":"Partner API","href":"/partner"}]}]},{"tab":"Integrations","pages":[{"title":"Integrations","href":"/integrations"}]},{"tab":"Examples \u0026 Tutorials","pages":[{"title":"Examples \u0026 Tutorials","href":"/guides/ai-voice-agent"}]},{"tab":"Blogs","pages":[{"title":"Blogs","href":"/blogs"}]}]},"basePath":"","title":"Purchase CPS or concurrency capacity - Vobiz","deploymentId":"dpl_53YqbBPsHdrqSGqXiWPGU7csRVod","buildId":"dpl_53YqbBPsHdrqSGqXiWPGU7csRVod","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-Ku9dSkH0.js","snippetPresets-Cjez4eet.js","utils-BqNa-fnS.js","style-to-object-BY3JEAdk.js","utils-DiE92JCe.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-Bi0DpqVf.js","conditional-requirements-CFM0id0Q.js","cloneDeep-C6xnxscF.js","_Uint8Array-B7g0OYAt.js","isObject-FP1Yky1u.js","Page--B9YZ09u.js","CodeSnippet-CTZvgJfu.js","DynamicMarkdown-CsgNpZb1.js","SectionHeading-C3K437Dy.js","icon-DlxjjqnB.js","ApiExamples-Bf8Ecb5t.js","usePlaygroundInputsStore-BA942cq6.js","shallow-D0sePNkF.js","isEqual-CnnQO8sL.js","CodeSnippets-BTANoy1T.js","getApiPlaygroundDisplay-BK2o1XYu.js","MethodPill-Cr7Ib9nN.js","getPastedJson-DXo3wtHt.js","Check2Icon-ChEI-f_B.js","axios-CsQoIw0U.js","Markdown-CH4mv0N8.js","AssistantPageLink-BHjmqccN.js","dist-DYCPzQwJ.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}