Base URL:https://api.vobiz.ai/api/v1/Account/{auth_id}/WhatsAppAuthentication: every request needs the X-Auth-ID: MA_XXXXXXXX and X-Auth-Token: YOUR_AUTH_TOKEN headers, and the {auth_id} in the path must be the account those credentials belong to. Send Content-Type: application/json on requests with a body. Get your credentials from console.vobiz.ai.
List WhatsApp channels
GET https://api.vobiz.ai/api/v1/Account/{auth_id}/WhatsApp/Channel/
Returns every WhatsApp channel connected to your Vobiz account, newest first, in an items array. The list isn’t paginated.
POST https://api.vobiz.ai/api/v1/Account/{auth_id}/WhatsApp/Channel/
Connect a WhatsApp Business number using your WABA credentials from Meta Business Manager. Each number can be connected once; a duplicate returns 400 with channel already exists. A bring_your_own channel starts with verification_statuspending until you complete BYON verification. Returns 201 Created with the new channel.
string
required
WhatsApp Business Account ID from Meta Business Manager.
string
Meta’s phone number ID. Required unless number_onboarding_mode is buy_from_vobiz.
string
required
The business phone number in E.164 format (e.g. +14155550100).
string
required
How you are connecting the number: buy_from_vobiz, bring_your_own, or embedded_signup. Case-insensitive.
string
required
A Meta access token with WhatsApp Business permissions for this WABA. Vobiz stores it encrypted and never returns it.
string
Display name to store with the channel.
string
Free-form label for who provides the number, for example vobiz.
string
The id of the number order, when you bought the number through Create number order.
POST https://api.vobiz.ai/api/v1/Account/{auth_id}/WhatsApp/Channel/EmbeddedSignup/
Complete channel creation after Meta’s Embedded Signup flow. Pass the authorization code returned by Meta. Vobiz exchanges the code for an access token, reads the number’s details from Meta, registers the number for the WhatsApp Cloud API, and subscribes to the WABA’s webhooks. To register a number you bought from Vobiz on the WABA instead, send number_provider set to vobiz with phone_number. Repeating the request for a number that is already connected returns the existing channel, so a retried submit is safe. Returns 201 Created.
string
required
The single-use authorization code returned by Meta’s Embedded Signup popup. Codes expire after about 10 minutes.
string
required
The WhatsApp Business Account ID returned by Embedded Signup.
string
Meta’s phone number ID returned by Embedded Signup. Required unless you are registering a Vobiz number (number_provider is vobiz and phone_number is set).
string
The Vobiz number to register on the WABA, in E.164 format. Used with number_provider set to vobiz.
string
Set to vobiz to register a number bought from Vobiz on the WABA instead of using a number already on it.
string
Accepted for compatibility. Vobiz sets the channel’s mode itself: buy_from_vobiz for a Vobiz number and embedded_signup otherwise.
string
The Meta partner solution ID used for Embedded Signup, when Vobiz gave you one.
The phone number and display name come from Meta, so phone_number uses Meta’s formatting and can include spaces and hyphens.
Update channel
PUT https://api.vobiz.ai/api/v1/Account/{auth_id}/WhatsApp/Channel/{id}/
Update an existing channel’s display name, or replace its Meta access token, for example after you rotate it in Meta Business Manager. Send at least one field; omitted fields keep their current value. An unknown channel returns 400 with channel not found or update failed. Returns 200 OK with the updated channel.
Disconnect a WhatsApp channel from your Vobiz account. The number stays registered with Meta, and the WABA is unchanged. Returns 204 No Content, or 404 for an unknown channel.
Deleting a channel stops messaging for that number through Vobiz and deletes the channel’s templates, conversations, messages, campaigns, and call logs on Vobiz.
Channel ID (UUID). Pass it as channel_id when you send messages, place calls, or create campaigns.
string
Your Vobiz account ID (MA_XXXXXXXX).
string
WhatsApp Business Account ID from Meta.
string
Meta’s phone number ID for this number. Empty for a buy_from_vobiz channel whose number is not yet registered with Meta.
string
The business phone number, as supplied when the channel was created, or as Meta formats it for Embedded Signup channels (which can include spaces and hyphens).
string
How the number was connected: buy_from_vobiz, bring_your_own, or embedded_signup.
string
Who provides the number, for example vobiz. Omitted when not set.
string
The number order this channel was created from. Omitted when there is none.
string
verified or pending. A channel is pending while bring_your_own verification is incomplete, or when a buy_from_vobiz channel was created without a phone_number_id.
string
The display name shown to customers. Omitted when empty.
string
Channel state. New channels are active.
string
Creation timestamp (RFC3339 UTC).
string
Last update timestamp (RFC3339 UTC).
The access_token is stored encrypted and is never returned in any API response.
Authorizations
X-Auth-ID
string
header
required
Your Vobiz account Auth ID (MA_XXXXXXXX).
X-Auth-Token
string
header
required
Your Vobiz account Auth Token.
Path Parameters
auth_id
string
required
Your account Auth ID. It must match the X-Auth-ID header.
Example:
"MA_XXXXXXXX"
Response
Your channels.
items
object[]
required
Your channels, newest first. Empty array when you have none.
{"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":[{"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":"site-roles","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},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"custom.css","href":"/docs/_mintlify/custom/vobizai/c4c76a1b5bc930af/custom.css"}]}
{"page":{"pagePath":"whatsapp/api/channels","slug":"/whatsapp/api/channels","pageMetadata":{"title":"WhatsApp Channels API — Connect WABA \u0026 Manage Tokens","description":"Create, update, and remove WhatsApp Business channels on Vobiz - connect your WABA, manage display names, and rotate access tokens via REST API.","openapi":"openapi-whatsapp.yaml GET /api/v1/Account/{auth_id}/WhatsApp/Channel/","keywords":["WhatsApp channels API","WABA channel management","WhatsApp Business channel","WhatsApp channel API","WhatsApp connection setup","WhatsApp display name","WhatsApp access tokens","manage WhatsApp channels","WABA setup API","WhatsApp channel CRUD","WhatsApp Business connection","multiple WhatsApp channels","WhatsApp channel provisioning","WABA channel India","WhatsApp Business account","WhatsApp channel update","WhatsApp BSP channel","WhatsApp channel endpoints","WhatsApp number connection","WhatsApp Business integration"],"href":"/whatsapp/api/channels"},"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: \"Create, update, and remove WhatsApp Business channels on Vobiz - connect your WABA, manage display names, and rotate access tokens via REST API.\"\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`,strong:`strong`,..._provideComponents(),...props.components},{CodeBlock,Heading,Note,ParamField,ResponseField,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Base URL:`}),` `,_jsx(_components.code,{children:`https://api.vobiz.ai/api/v1/Account/{auth_id}/WhatsApp`})]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Authentication:`}),` every request needs the `,_jsx(_components.code,{children:`X-Auth-ID: MA_XXXXXXXX`}),` and `,_jsx(_components.code,{children:`X-Auth-Token: YOUR_AUTH_TOKEN`}),` headers, and the `,_jsx(_components.code,{children:`{auth_id}`}),` in the path must be the account those credentials belong to. Send `,_jsx(_components.code,{children:`Content-Type: application/json`}),` on requests with a body. Get your credentials from `,_jsx(_components.a,{href:`https://console.vobiz.ai`,children:`console.vobiz.ai`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`list-whatsapp-channels`,children:`List WhatsApp channels`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,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:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`GET`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` https://api.vobiz.ai/api/v1/Account/{auth_id}/WhatsApp/Channel/`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Returns every WhatsApp channel connected to your Vobiz account, newest first, in an `,_jsx(_components.code,{children:`items`}),` array. The list isn’t paginated.`]}),`\n`,_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`4`,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:`4`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` GET`}),_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/Account/MA_XXXXXXXX/WhatsApp/Channel/\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"X-Auth-ID: MA_XXXXXXXX\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"X-Auth-Token: YOUR_AUTH_TOKEN\"`})]}),`\n`]})})}),`\n`,_jsx(CodeBlock,{filename:`200 OK`,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:` \"items\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#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:`\"0a8f3feb-9598-47f2-8a6c-df1aeb306ae1\"`}),_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:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"MA_XXXXXXXX\"`}),_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:` \"waba_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"123456789012345\"`}),_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:` \"phone_number_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"109876543210987\"`}),_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:` \"phone_number\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"+14155550100\"`}),_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:` \"number_onboarding_mode\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"embedded_signup\"`}),_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:` \"verification_status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"verified\"`}),_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:` \"display_name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Acme Support\"`}),_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:` \"created_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-10-05T11:35:20Z\"`}),_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-10-05T11:35:20Z\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`create-whatsapp-channel`,children:`Create WhatsApp channel`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,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:`1`,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/Account/{auth_id}/WhatsApp/Channel/`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Connect a WhatsApp Business number using your WABA credentials from Meta Business Manager. Each number can be connected once; a duplicate returns `,_jsx(_components.code,{children:`400`}),` with `,_jsx(_components.code,{children:`channel already exists`}),`. A `,_jsx(_components.code,{children:`bring_your_own`}),` channel starts with `,_jsx(_components.code,{children:`verification_status`}),` `,_jsx(_components.code,{children:`pending`}),` until you complete `,_jsx(_components.a,{href:`/whatsapp/api/numbers#byon-verification-flow`,children:`BYON verification`}),`. Returns `,_jsx(_components.code,{children:`201 Created`}),` with the new channel.`]}),`\n`,_jsx(ParamField,{body:`waba_id`,type:`string`,required:true,id:`param-waba-id`,children:_jsx(_components.p,{children:`WhatsApp Business Account ID from Meta Business Manager.`})}),`\n`,_jsx(ParamField,{body:`phone_number_id`,type:`string`,id:`param-phone-number-id`,children:_jsxs(_components.p,{children:[`Meta’s phone number ID. Required unless `,_jsx(_components.code,{children:`number_onboarding_mode`}),` is `,_jsx(_components.code,{children:`buy_from_vobiz`}),`.`]})}),`\n`,_jsx(ParamField,{body:`phone_number`,type:`string`,required:true,id:`param-phone-number`,children:_jsxs(_components.p,{children:[`The business phone number in E.164 format (e.g. `,_jsx(_components.code,{children:`+14155550100`}),`).`]})}),`\n`,_jsx(ParamField,{body:`number_onboarding_mode`,type:`string`,required:true,id:`param-number-onboarding-mode`,children:_jsxs(_components.p,{children:[`How you are connecting the number: `,_jsx(_components.code,{children:`buy_from_vobiz`}),`, `,_jsx(_components.code,{children:`bring_your_own`}),`, or `,_jsx(_components.code,{children:`embedded_signup`}),`. Case-insensitive.`]})}),`\n`,_jsx(ParamField,{body:`access_token`,type:`string`,required:true,id:`param-access-token`,children:_jsx(_components.p,{children:`A Meta access token with WhatsApp Business permissions for this WABA. Vobiz stores it encrypted and never returns it.`})}),`\n`,_jsx(ParamField,{body:`display_name`,type:`string`,id:`param-display-name`,children:_jsx(_components.p,{children:`Display name to store with the channel.`})}),`\n`,_jsx(ParamField,{body:`number_provider`,type:`string`,id:`param-number-provider`,children:_jsxs(_components.p,{children:[`Free-form label for who provides the number, for example `,_jsx(_components.code,{children:`vobiz`}),`.`]})}),`\n`,_jsx(ParamField,{body:`number_order_id`,type:`string`,id:`param-number-order-id`,children:_jsxs(_components.p,{children:[`The `,_jsx(_components.code,{children:`id`}),` of the number order, when you bought the number through `,_jsx(_components.a,{href:`/whatsapp/api/numbers#create-number-order`,children:`Create number order`}),`.`]})}),`\n`,_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`13`,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:`13`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#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/Account/MA_XXXXXXXX/WhatsApp/Channel/\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"X-Auth-ID: MA_XXXXXXXX\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"X-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:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"waba_id\": \"123456789012345\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"phone_number_id\": \"109876543210987\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"phone_number\": \"+14155550100\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"number_onboarding_mode\": \"bring_your_own\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"access_token\": \"YOUR_META_ACCESS_TOKEN\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"display_name\": \"Acme Support\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),`\n`,_jsx(CodeBlock,{filename:`201 Created`,numberOfLines:`13`,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:`13`,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:`\"0a8f3feb-9598-47f2-8a6c-df1aeb306ae1\"`}),_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:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"MA_XXXXXXXX\"`}),_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:` \"waba_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"123456789012345\"`}),_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:` \"phone_number_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"109876543210987\"`}),_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:` \"phone_number\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"+14155550100\"`}),_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:` \"number_onboarding_mode\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"bring_your_own\"`}),_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:` \"verification_status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"pending\"`}),_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:` \"display_name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Acme Support\"`}),_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:` \"created_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-10-05T11:35:20Z\"`}),_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-10-05T11:35:20Z\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`embedded-signup`,children:`Embedded signup`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,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:`1`,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/Account/{auth_id}/WhatsApp/Channel/EmbeddedSignup/`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Complete channel creation after Meta’s Embedded Signup flow. Pass the authorization code returned by Meta. Vobiz exchanges the code for an access token, reads the number’s details from Meta, registers the number for the WhatsApp Cloud API, and subscribes to the WABA’s webhooks. To register a number you bought from Vobiz on the WABA instead, send `,_jsx(_components.code,{children:`number_provider`}),` set to `,_jsx(_components.code,{children:`vobiz`}),` with `,_jsx(_components.code,{children:`phone_number`}),`. Repeating the request for a number that is already connected returns the existing channel, so a retried submit is safe. Returns `,_jsx(_components.code,{children:`201 Created`}),`.`]}),`\n`,_jsx(ParamField,{body:`code`,type:`string`,required:true,id:`param-code`,children:_jsx(_components.p,{children:`The single-use authorization code returned by Meta’s Embedded Signup popup. Codes expire after about 10 minutes.`})}),`\n`,_jsx(ParamField,{body:`waba_id`,type:`string`,required:true,id:`param-waba-id-1`,children:_jsx(_components.p,{children:`The WhatsApp Business Account ID returned by Embedded Signup.`})}),`\n`,_jsx(ParamField,{body:`phone_number_id`,type:`string`,id:`param-phone-number-id-1`,children:_jsxs(_components.p,{children:[`Meta’s phone number ID returned by Embedded Signup. Required unless you are registering a Vobiz number (`,_jsx(_components.code,{children:`number_provider`}),` is `,_jsx(_components.code,{children:`vobiz`}),` and `,_jsx(_components.code,{children:`phone_number`}),` is set).`]})}),`\n`,_jsx(ParamField,{body:`phone_number`,type:`string`,id:`param-phone-number-1`,children:_jsxs(_components.p,{children:[`The Vobiz number to register on the WABA, in E.164 format. Used with `,_jsx(_components.code,{children:`number_provider`}),` set to `,_jsx(_components.code,{children:`vobiz`}),`.`]})}),`\n`,_jsx(ParamField,{body:`number_provider`,type:`string`,id:`param-number-provider-1`,children:_jsxs(_components.p,{children:[`Set to `,_jsx(_components.code,{children:`vobiz`}),` to register a number bought from Vobiz on the WABA instead of using a number already on it.`]})}),`\n`,_jsx(ParamField,{body:`number_onboarding_mode`,type:`string`,id:`param-number-onboarding-mode-1`,children:_jsxs(_components.p,{children:[`Accepted for compatibility. Vobiz sets the channel’s mode itself: `,_jsx(_components.code,{children:`buy_from_vobiz`}),` for a Vobiz number and `,_jsx(_components.code,{children:`embedded_signup`}),` otherwise.`]})}),`\n`,_jsx(ParamField,{body:`solution_id`,type:`string`,id:`param-solution-id`,children:_jsx(_components.p,{children:`The Meta partner solution ID used for Embedded Signup, when Vobiz gave you one.`})}),`\n`,_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`10`,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:`10`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#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/Account/MA_XXXXXXXX/WhatsApp/Channel/EmbeddedSignup/\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"X-Auth-ID: MA_XXXXXXXX\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"X-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:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"code\": \"AQBx...authorization-code\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"waba_id\": \"123456789012345\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"phone_number_id\": \"109876543210987\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),`\n`,_jsx(CodeBlock,{filename:`201 Created`,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:` \"channel\"`}),_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:`\"0a8f3feb-9598-47f2-8a6c-df1aeb306ae1\"`}),_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:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"MA_XXXXXXXX\"`}),_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:` \"waba_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"123456789012345\"`}),_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:` \"phone_number_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"109876543210987\"`}),_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:` \"phone_number\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"+1 415-555-0100\"`}),_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:` \"number_onboarding_mode\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"embedded_signup\"`}),_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:` \"verification_status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"verified\"`}),_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:` \"display_name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Acme Support\"`}),_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:` \"created_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-10-05T11:35:20Z\"`}),_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-10-05T11:35:20Z\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"phone_number\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"+1 415-555-0100\"`}),_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:` \"display_name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Acme Support\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`The phone number and display name come from Meta, so `,_jsx(_components.code,{children:`phone_number`}),` uses Meta’s formatting and can include spaces and hyphens.`]}),`\n`,_jsx(Heading,{level:`2`,id:`update-channel`,children:`Update channel`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,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:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`PUT`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` https://api.vobiz.ai/api/v1/Account/{auth_id}/WhatsApp/Channel/{id}/`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Update an existing channel’s display name, or replace its Meta access token, for example after you rotate it in Meta Business Manager. Send at least one field; omitted fields keep their current value. An unknown channel returns `,_jsx(_components.code,{children:`400`}),` with `,_jsx(_components.code,{children:`channel not found or update failed`}),`. Returns `,_jsx(_components.code,{children:`200 OK`}),` with the updated channel.`]}),`\n`,_jsx(ParamField,{body:`access_token`,type:`string`,id:`param-access-token-1`,children:_jsx(_components.p,{children:`A new Meta access token. It can’t be empty.`})}),`\n`,_jsx(ParamField,{body:`display_name`,type:`string`,id:`param-display-name-1`,children:_jsx(_components.p,{children:`New display name.`})}),`\n`,_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:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` PUT`}),_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/Account/MA_XXXXXXXX/WhatsApp/Channel/0a8f3feb-9598-47f2-8a6c-df1aeb306ae1/\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"X-Auth-ID: MA_XXXXXXXX\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"X-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:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"display_name\": \"Acme Support\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"access_token\": \"YOUR_META_ACCESS_TOKEN\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`delete-channel`,children:`Delete channel`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,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:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`DELETE`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` https://api.vobiz.ai/api/v1/Account/{auth_id}/WhatsApp/Channel/{id}/`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Disconnect a WhatsApp channel from your Vobiz account. The number stays registered with Meta, and the WABA is unchanged. Returns `,_jsx(_components.code,{children:`204 No Content`}),`, or `,_jsx(_components.code,{children:`404`}),` for an unknown channel.`]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`Deleting a channel stops messaging for that number through Vobiz and deletes the channel’s templates, conversations, messages, campaigns, and call logs on Vobiz.`})}),`\n`,_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`4`,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:`4`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` DELETE`}),_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/Account/MA_XXXXXXXX/WhatsApp/Channel/0a8f3feb-9598-47f2-8a6c-df1aeb306ae1/\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"X-Auth-ID: MA_XXXXXXXX\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"X-Auth-Token: YOUR_AUTH_TOKEN\"`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`channel-object`,children:`Channel object`}),`\n`,_jsx(ResponseField,{name:`id`,type:`string`,id:`param-id`,children:_jsxs(_components.p,{children:[`Channel ID (UUID). Pass it as `,_jsx(_components.code,{children:`channel_id`}),` when you send messages, place calls, or create campaigns.`]})}),`\n`,_jsx(ResponseField,{name:`account_id`,type:`string`,id:`param-account-id`,children:_jsxs(_components.p,{children:[`Your Vobiz account ID (`,_jsx(_components.code,{children:`MA_XXXXXXXX`}),`).`]})}),`\n`,_jsx(ResponseField,{name:`waba_id`,type:`string`,id:`param-waba-id-2`,children:_jsx(_components.p,{children:`WhatsApp Business Account ID from Meta.`})}),`\n`,_jsx(ResponseField,{name:`phone_number_id`,type:`string`,id:`param-phone-number-id-2`,children:_jsxs(_components.p,{children:[`Meta’s phone number ID for this number. Empty for a `,_jsx(_components.code,{children:`buy_from_vobiz`}),` channel whose number is not yet registered with Meta.`]})}),`\n`,_jsx(ResponseField,{name:`phone_number`,type:`string`,id:`param-phone-number-2`,children:_jsx(_components.p,{children:`The business phone number, as supplied when the channel was created, or as Meta formats it for Embedded Signup channels (which can include spaces and hyphens).`})}),`\n`,_jsx(ResponseField,{name:`number_onboarding_mode`,type:`string`,id:`param-number-onboarding-mode-2`,children:_jsxs(_components.p,{children:[`How the number was connected: `,_jsx(_components.code,{children:`buy_from_vobiz`}),`, `,_jsx(_components.code,{children:`bring_your_own`}),`, or `,_jsx(_components.code,{children:`embedded_signup`}),`.`]})}),`\n`,_jsx(ResponseField,{name:`number_provider`,type:`string`,id:`param-number-provider-2`,children:_jsxs(_components.p,{children:[`Who provides the number, for example `,_jsx(_components.code,{children:`vobiz`}),`. Omitted when not set.`]})}),`\n`,_jsx(ResponseField,{name:`number_order_id`,type:`string`,id:`param-number-order-id-1`,children:_jsx(_components.p,{children:`The number order this channel was created from. Omitted when there is none.`})}),`\n`,_jsx(ResponseField,{name:`verification_status`,type:`string`,id:`param-verification-status`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`verified`}),` or `,_jsx(_components.code,{children:`pending`}),`. A channel is `,_jsx(_components.code,{children:`pending`}),` while `,_jsx(_components.code,{children:`bring_your_own`}),` verification is incomplete, or when a `,_jsx(_components.code,{children:`buy_from_vobiz`}),` channel was created without a `,_jsx(_components.code,{children:`phone_number_id`}),`.`]})}),`\n`,_jsx(ResponseField,{name:`display_name`,type:`string`,id:`param-display-name-2`,children:_jsx(_components.p,{children:`The display name shown to customers. Omitted when empty.`})}),`\n`,_jsx(ResponseField,{name:`status`,type:`string`,id:`param-status`,children:_jsxs(_components.p,{children:[`Channel state. New channels are `,_jsx(_components.code,{children:`active`}),`.`]})}),`\n`,_jsx(ResponseField,{name:`created_at`,type:`string`,id:`param-created-at`,children:_jsx(_components.p,{children:`Creation timestamp (RFC3339 UTC).`})}),`\n`,_jsx(ResponseField,{name:`updated_at`,type:`string`,id:`param-updated-at`,children:_jsx(_components.p,{children:`Last update timestamp (RFC3339 UTC).`})}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`The `,_jsx(_components.code,{children:`access_token`}),` is stored encrypted and is `,_jsx(_components.strong,{children:`never`}),` returned in any API response.`]})})]})}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":"WhatsApp Channels API — Connect WABA \u0026 Manage Tokens","description":"Create, update, and remove WhatsApp Business channels on Vobiz - connect your WABA, manage display names, and rotate access tokens via REST API.","openapi":"openapi-whatsapp.yaml GET /api/v1/Account/{auth_id}/WhatsApp/Channel/","keywords":["WhatsApp channels API","WABA channel management","WhatsApp Business channel","WhatsApp channel API","WhatsApp connection setup","WhatsApp display name","WhatsApp access tokens","manage WhatsApp channels","WABA setup API","WhatsApp channel CRUD","WhatsApp Business connection","multiple WhatsApp channels","WhatsApp channel provisioning","WABA channel India","WhatsApp Business account","WhatsApp channel update","WhatsApp BSP channel","WhatsApp channel endpoints","WhatsApp number connection","WhatsApp Business integration"],"href":"/whatsapp/api/channels"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"List WhatsApp channels","slug":"list-whatsapp-channels","depth":2,"children":[]},{"title":"Create WhatsApp channel","slug":"create-whatsapp-channel","depth":2,"children":[]},{"title":"Embedded signup","slug":"embedded-signup","depth":2,"children":[]},{"title":"Update channel","slug":"update-channel","depth":2,"children":[]},{"title":"Delete channel","slug":"delete-channel","depth":2,"children":[]},{"title":"Channel object","slug":"channel-object","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/docs/_mintlify/custom/vobizai/478834ae2c200a0e/blog-schema.js","/docs/_mintlify/custom/vobizai/13b0cd7ec6e39877/anchor-link-text.js"],"openApiReferenceData":{"operation":{"tags":["Channels"],"summary":"List channels","description":"Create, update, and remove WhatsApp Business channels on Vobiz - connect your WABA, manage display names, and rotate access tokens via REST API.","operationId":"whatsapp-list-channels","responses":{"200":"e11a7c9d-f173-4e0d-90e9-5f938cd53cb0","401":"cc1626e2-5cf2-44af-9749-33f941beb350","403":"59538f43-586c-4ab3-a76c-b51cde11c21f","500":"232f6bfc-5240-420a-82ee-0a2daf944586"},"method":"get","type":"path","servers":["ca7d3c8e-f917-4390-a962-8336b70e4a60"],"security":["d8ef9c4b-f6c6-4cce-83d2-a8fc5d3da734"],"path":"/api/v1/Account/{auth_id}/WhatsApp/Channel/","baseUrlOptions":["https://api.vobiz.ai"],"title":"List channels","codeSamples":[],"requestExampleLanguages":["bash","python","javascript"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[]},"dependencies":{"parameters":{"63f2806f-db04-411f-8eab-cda26b925f84":{"name":"auth_id","in":"path","required":true,"description":"Your account Auth ID. It must match the `X-Auth-ID` header.","schema":{"type":"string","example":"MA_XXXXXXXX","isRequired":true,"description":"Your account Auth ID. It must match the `X-Auth-ID` header.","uniqueKey":"","typeLabel":"string"}}},"responses":{"e11a7c9d-f173-4e0d-90e9-5f938cd53cb0":{"description":"Your channels.","content":{"application/json":{"schema":{"type":"object","required":["items"],"properties":{"items":{"type":"array","description":"Your channels, newest first. Empty array when you have none.","items":{"type":"object","description":"A WhatsApp Business phone number connected to your account.","required":["id","account_id","waba_id","phone_number_id","phone_number","number_onboarding_mode","verification_status","status","created_at","updated_at"],"properties":{"id":{"type":"string","format":"uuid","description":"Channel ID. Pass it as `channel_id` when you send messages, place calls or create campaigns.","example":"0a8f3feb-9598-47f2-8a6c-df1aeb306ae1","isRequired":true,"uniqueKey":"\\items.items.[INDEX].id","typeLabel":"string\u003cuuid>"},"account_id":{"type":"string","description":"Your account Auth ID.","example":"MA_XXXXXXXX","isRequired":true,"uniqueKey":"\\items.items.[INDEX].account_id","typeLabel":"string"},"waba_id":{"type":"string","description":"The WhatsApp Business Account (WABA) ID from Meta.","example":"123456789012345","isRequired":true,"uniqueKey":"\\items.items.[INDEX].waba_id","typeLabel":"string"},"phone_number_id":{"type":"string","description":"Meta's phone number ID for this number. Empty for a `buy_from_vobiz` channel whose number is not yet registered with Meta.","example":"109876543210987","isRequired":true,"uniqueKey":"\\items.items.[INDEX].phone_number_id","typeLabel":"string"},"phone_number":{"type":"string","description":"The business phone number, as supplied when the channel was created or as Meta formats it for Embedded Signup channels (which can include spaces and hyphens).","example":"+14155550100","isRequired":true,"uniqueKey":"\\items.items.[INDEX].phone_number","typeLabel":"string"},"number_onboarding_mode":{"type":"string","enum":["buy_from_vobiz","bring_your_own","embedded_signup"],"description":"How the number was connected.","example":"embedded_signup","isRequired":true,"uniqueKey":"\\items.items.[INDEX].number_onboarding_mode","typeLabel":"enum\u003cstring>"},"verification_status":{"type":"string","enum":["verified","pending"],"description":"`pending` for `bring_your_own` channels until BYON verification completes, and for `buy_from_vobiz` channels created without a `phone_number_id`. Otherwise `verified`.","example":"verified","isRequired":true,"uniqueKey":"\\items.items.[INDEX].verification_status","typeLabel":"enum\u003cstring>"},"status":{"type":"string","description":"Channel state. New channels are `active`.","example":"active","isRequired":true,"uniqueKey":"\\items.items.[INDEX].status","typeLabel":"string"},"created_at":{"type":"string","format":"date-time","example":"2026-10-05T11:35:20Z","isRequired":true,"uniqueKey":"\\items.items.[INDEX].created_at","typeLabel":"string\u003cdate-time>"},"updated_at":{"type":"string","format":"date-time","example":"2026-10-05T11:35:20Z","isRequired":true,"uniqueKey":"\\items.items.[INDEX].updated_at","typeLabel":"string\u003cdate-time>"},"number_provider":{"type":"string","description":"Who provides the number, for example `vobiz`. Omitted when not set.","example":"vobiz","uniqueKey":"\\items.items.[INDEX].number_provider","typeLabel":"string"},"number_order_id":{"type":"string","description":"The number order this channel was created from. Omitted when there is none.","example":"5c2e8a1f-3b7d-4e9a-8c6f-1d2b3a4c5e6f","uniqueKey":"\\items.items.[INDEX].number_order_id","typeLabel":"string"},"display_name":{"type":"string","description":"The display name shown to customers. Omitted when empty.","example":"Acme Support","uniqueKey":"\\items.items.[INDEX].display_name","typeLabel":"string"}},"uniqueKey":"\\items.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"\\items","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"example":{"items":[{"id":"0a8f3feb-9598-47f2-8a6c-df1aeb306ae1","account_id":"MA_XXXXXXXX","waba_id":"123456789012345","phone_number_id":"109876543210987","phone_number":"+1 415-555-0100","number_onboarding_mode":"embedded_signup","verification_status":"verified","display_name":"Acme Support","status":"active","created_at":"2026-10-05T11:35:20.074199Z","updated_at":"2026-10-05T11:35:20.074199Z"}]},"examples":{"Example":{"title":"Example","value":{"items":[{"id":"0a8f3feb-9598-47f2-8a6c-df1aeb306ae1","account_id":"MA_XXXXXXXX","waba_id":"123456789012345","phone_number_id":"109876543210987","phone_number":"+1 415-555-0100","number_onboarding_mode":"embedded_signup","verification_status":"verified","display_name":"Acme Support","status":"active","created_at":"2026-10-05T11:35:20.074199Z","updated_at":"2026-10-05T11:35:20.074199Z"}]}}},"exampleType":"examples"}},"exampleType":"examples"},"cc1626e2-5cf2-44af-9749-33f941beb350":{"description":"Missing or invalid `X-Auth-ID` / `X-Auth-Token`.","content":{"application/json":{"schema":{"type":"object","description":"The body of an authentication (`401`) or authorization (`403`) error.","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"integer","description":"The HTTP status code, repeated.","example":401,"isRequired":true,"uniqueKey":"error.code","typeLabel":"integer"},"message":{"type":"string","description":"What went wrong.","example":"Invalid authentication credentials","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"invalid":{"title":"invalid","summary":"Invalid credentials","value":{"error":{"code":401,"message":"Invalid authentication credentials"}}},"missing":{"title":"missing","summary":"Missing credentials","value":{"error":{"code":401,"message":"Authentication required: provide either Authorization header or X-Auth-ID and X-Auth-Token headers"}}}},"exampleType":"examples"}},"exampleType":"examples"},"59538f43-586c-4ab3-a76c-b51cde11c21f":{"description":"The `{auth_id}` in the path is not the account your credentials belong to.","content":{"application/json":{"schema":{"type":"object","description":"The body of an authentication (`401`) or authorization (`403`) error.","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"integer","description":"The HTTP status code, repeated.","example":401,"isRequired":true,"uniqueKey":"error.code","typeLabel":"integer"},"message":{"type":"string","description":"What went wrong.","example":"Invalid authentication credentials","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":403,"message":"Access denied: account ID mismatch"}},"examples":{"Example":{"title":"Example","value":{"error":{"code":403,"message":"Access denied: account ID mismatch"}}}},"exampleType":"examples"}},"exampleType":"examples"},"232f6bfc-5240-420a-82ee-0a2daf944586":{"description":"The request couldn't be completed. Retry it, and contact Vobiz support if the error persists.","content":{"application/json":{"schema":{"type":"object","description":"An error response: a flat object with one `error` string. Use the HTTP status code to decide how to handle the error, and log `error` for diagnosis.","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable explanation of the error. Branch on the HTTP status code rather than on this text.","example":"channel not found","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"channel not found"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"d8ef9c4b-f6c6-4cce-83d2-a8fc5d3da734":{"AuthID":{"type":"apiKey","in":"header","name":"X-Auth-ID","description":"Your Vobiz account Auth ID (`MA_XXXXXXXX`).","scopes":[],"schemeName":"AuthID"},"AuthToken":{"type":"apiKey","in":"header","name":"X-Auth-Token","description":"Your Vobiz account Auth Token.","scopes":[],"schemeName":"AuthToken"}}},"servers":{"ca7d3c8e-f917-4390-a962-8336b70e4a60":{"url":"https://api.vobiz.ai","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-Auth-ID","description":"Your Vobiz account Auth ID (`MA_XXXXXXXX`).","scopes":[],"schemeName":"AuthID"},"schema":{"title":"X-Auth-ID","type":"string","description":"Your Vobiz account Auth ID (`MA_XXXXXXXX`).","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-whatsapp.yaml"},"subdomain":"vobizai","siteName":"Vobiz","title":"WhatsApp Channels API — Connect WABA \u0026 Manage Tokens - Vobiz","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-18T21:29:01.359Z","originalFileLocation":"whatsapp/api/channels.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=\"Create, update, and remove WhatsApp Business channels on Vobiz - connect your WABA, manage display names, and rotate access tokens via REST API.\">\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=\"WhatsApp Channels API — Connect WABA \u0026amp; Manage Tokens - Vobiz\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create, update, and remove WhatsApp Business channels on Vobiz - connect your WABA, manage display names, and rotate access tokens via REST API.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Vobiz Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://www.vobiz.ai/docs/whatsapp/api/channels\">\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=WhatsApp+Business+API\u0026amp;title=WhatsApp+Channels+API+%E2%80%94+Connect+WABA+%26+Manage+Tokens\u0026amp;description=Create%2C+update%2C+and+remove+WhatsApp+Business+channels+on+Vobiz+-+connect+your+WABA%2C+manage+display+names%2C+and+rotate+access+tokens+via+REST+API.\u0026amp;theme=d9cfb5a257c4db351c1c1eeb\u0026amp;signature=0b65e6af9e701596fbf6a346aeed7ff7fe42a6587dae747dac6faca886584f63\">\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=\"WhatsApp Channels API — Connect WABA \u0026amp; Manage Tokens - Vobiz\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create, update, and remove WhatsApp Business channels on Vobiz - connect your WABA, manage display names, and rotate access tokens via REST API.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://vobizai.mintlify.site/docs/_mintlify/api/og/v2?division=WhatsApp+Business+API\u0026amp;title=WhatsApp+Channels+API+%E2%80%94+Connect+WABA+%26+Manage+Tokens\u0026amp;description=Create%2C+update%2C+and+remove+WhatsApp+Business+channels+on+Vobiz+-+connect+your+WABA%2C+manage+display+names%2C+and+rotate+access+tokens+via+REST+API.\u0026amp;theme=d9cfb5a257c4db351c1c1eeb\u0026amp;signature=0b65e6af9e701596fbf6a346aeed7ff7fe42a6587dae747dac6faca886584f63\">\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/whatsapp/api/channels\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/whatsapp/api/channels.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/whatsapp/api/channels#webpage\",\"url\":\"https://www.vobiz.ai/docs/whatsapp/api/channels\",\"name\":\"WhatsApp Channels API — Connect WABA \u0026 Manage Tokens\",\"description\":\"Create, update, and remove WhatsApp Business channels on Vobiz - connect your WABA, manage display names, and rotate access tokens via REST API.\",\"dateModified\":\"2026-11-18T21:29:01.359Z\",\"isPartOf\":{\"@id\":\"https://www.vobiz.ai/docs#website\"},\"breadcrumb\":{\"@id\":\"https://www.vobiz.ai/docs/whatsapp/api/channels#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://www.vobiz.ai/docs/whatsapp/api/channels#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"WhatsApp Business API\",\"item\":\"https://www.vobiz.ai/docs/whatsapp/api\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"WhatsApp Channels API — Connect WABA \u0026 Manage Tokens\",\"item\":\"https://www.vobiz.ai/docs/whatsapp/api/channels\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://www.vobiz.ai/docs/whatsapp/api/channels#apireference\",\"headline\":\"WhatsApp Channels API — Connect WABA \u0026 Manage Tokens\",\"name\":\"WhatsApp Channels API — Connect WABA \u0026 Manage Tokens\",\"description\":\"Create, update, and remove WhatsApp Business channels on Vobiz - connect your WABA, manage display names, and rotate access tokens via REST API.\",\"url\":\"https://www.vobiz.ai/docs/whatsapp/api/channels\",\"mainEntityOfPage\":{\"@id\":\"https://www.vobiz.ai/docs/whatsapp/api/channels#webpage\"},\"dateModified\":\"2026-11-18T21:29:01.359Z\",\"keywords\":\"WhatsApp channels API, WABA channel management, WhatsApp Business channel, WhatsApp channel API, WhatsApp connection setup, WhatsApp display name, WhatsApp access tokens, manage WhatsApp channels, WABA setup API, WhatsApp channel CRUD, WhatsApp Business connection, multiple WhatsApp channels, WhatsApp channel provisioning, WABA channel India, WhatsApp Business account, WhatsApp channel update, WhatsApp BSP channel, WhatsApp channel endpoints, WhatsApp number connection, WhatsApp Business integration\",\"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/whatsapp/api/channels.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","pages":[{"title":"Regular APIs","href":"/account"}]},{"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","groups":[{"group":"Getting Started","icon":"rocket","pages":[{"title":"WhatsApp Business API Introduction — Features \u0026 Coverage","href":"/whatsapp/getting-started/introduction"},{"title":"WhatsApp Business Prerequisites — Meta Account \u0026 Number","href":"/whatsapp/getting-started/prerequisites"},{"title":"WhatsApp Business Quick Start — Send Your First Message","href":"/whatsapp/getting-started/quick-start"},{"title":"WhatsApp Console Walkthrough — Signup, Templates \u0026 Campaigns","sidebarTitle":"Console Walkthrough","href":"/whatsapp/getting-started/console-walkthrough"}]},{"group":"Channel Management","icon":"satellite-dish","root":{"title":"WhatsApp Channel Management — Connect \u0026 Monitor WABA","href":"/whatsapp/channels"},"pages":[{"title":"Bring Your Own Number (BYON) Setup Guide","href":"/whatsapp/channels/byon"}]},{"group":"Messaging","icon":"message","root":{"title":"WhatsApp Messaging — Message Types, 24-Hour Window \u0026 Templates","href":"/whatsapp/messaging"},"pages":[{"title":"Using the WhatsApp Inbox","href":"/whatsapp/messaging/inbox"},{"title":"WhatsApp Message Templates","href":"/whatsapp/messaging/templates"}]},{"group":"Webhooks","icon":"webhook","root":{"title":"WhatsApp Webhooks — Receive Message \u0026 Delivery Events","href":"/whatsapp/webhooks"},"pages":[{"title":"WhatsApp Webhook Events — Inbound, Status \u0026 Call Payloads","href":"/whatsapp/webhooks/events"}]},{"group":"WhatsApp Business API","icon":"code","root":{"title":"Vobiz WhatsApp Business API","sidebarTitle":"WhatsApp API overview","href":"/whatsapp/api"},"pages":[{"title":"WhatsApp API Authentication — X-Auth-ID \u0026 X-Auth-Token Headers","href":"/whatsapp/api/authentication"},{"title":"WhatsApp Send Message API — Text, Media \u0026 Template Messages","description":"Send WhatsApp messages via the Vobiz REST API - text, images, video, audio, documents, stickers, and Meta-approved templates over a single endpoint.","openapi":"openapi-whatsapp.yaml POST /api/v1/Account/{auth_id}/WhatsApp/Message/","href":"/whatsapp/api/send-message"},{"title":"WhatsApp Channels API — Connect WABA \u0026 Manage Tokens","openapi":"openapi-whatsapp.yaml GET /api/v1/Account/{auth_id}/WhatsApp/Channel/","href":"/whatsapp/api/channels"},{"title":"WhatsApp Numbers API — Search, Purchase \u0026 BYON Verification","description":"Search and purchase WhatsApp-capable numbers on Vobiz, or verify and connect an existing number via BYON - OTP-based ownership verification included.","openapi":"openapi-whatsapp.yaml GET /api/v1/Account/{auth_id}/WhatsApp/Number/Availability/","href":"/whatsapp/api/numbers"},{"title":"WhatsApp Conversations API — List \u0026 Paginate Message Threads","openapi":"openapi-whatsapp.yaml GET /api/v1/Account/{auth_id}/WhatsApp/Conversation/","href":"/whatsapp/api/conversations"},{"title":"WhatsApp Contacts API — Create, Tag \u0026 Bulk Import via CSV","openapi":"openapi-whatsapp.yaml GET /api/v1/Account/{auth_id}/WhatsApp/Contact/","href":"/whatsapp/api/contacts"},{"title":"WhatsApp Templates API — Submit \u0026 Manage Templates","openapi":"openapi-whatsapp.yaml GET /api/v1/Account/{auth_id}/WhatsApp/Channel/{channelId}/Template/","href":"/whatsapp/api/templates"},{"title":"WhatsApp Campaigns API — Bulk Template Broadcasts","openapi":"openapi-whatsapp.yaml POST /api/v1/Account/{auth_id}/WhatsApp/Campaign/","href":"/whatsapp/api/campaigns"},{"title":"WhatsApp Canned Responses API — Reply Shortcuts","openapi":"openapi-whatsapp.yaml GET /api/v1/Account/{auth_id}/WhatsApp/CannedResponse/","href":"/whatsapp/api/canned-responses"},{"title":"WhatsApp Calls API — Initiate \u0026 Manage Business Voice Calls","openapi":"openapi-whatsapp.yaml POST /api/v1/Account/{auth_id}/WhatsApp/Call/","href":"/whatsapp/api/calls"},{"title":"WhatsApp Webhooks API — Subscribe to Delivery \u0026 Inbound Events","openapi":"openapi-whatsapp.yaml POST /api/v1/Account/{auth_id}/WhatsApp/Webhook/","href":"/whatsapp/api/webhooks"}]}]},{"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":"WhatsApp Channels API — Connect WABA \u0026 Manage Tokens - 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"]}