List connected WhatsApp phone numbers for the authenticated business. Call this before creating a workflow: if more than one number is returned, ask the user which one to bind. Copy the chosen row’s id into the workflow associatedToBusinessId (not associatedBusinessId, which is the WABA id) and set platformType. For a starter/outbound bot (or a named catalog template), pass the same id as phoneNumberId on GET /templates. Skip GET /templates for inbound reply bots (pingmeeTrigger) unless the user named a template. Facebook pages and Instagram accounts are not in this list. See /build-workflows/document (platform binding) and /build-workflows/overview.
Connected WhatsApp numbers for the authenticated business. Use this before creating a workflow.
Call this endpoint.
If phoneNumbers has more than one row, ask the user which number the bot should send from.
Copy that row’s id into the workflow’s associatedToBusinessId and set platformType to whatsapp. Do not use associatedBusinessId (that is the WABA id).
For a starter / outbound bot (or a named catalog template), pass the same id as phoneNumberId when fetching templates. Skip GET /templates for inbound reply bots unless the user named a template.
See Platform binding.This list does not include Facebook pages or Instagram accounts. There is no public list-pages API.
Connected WhatsApp numbers. Use id as workflow associatedToBusinessId.
Show child attributes
Last modified on September 4, 2026
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Pingmee","colors":{"primary":"#16A34A","light":"#07C983","dark":"#15803D"},"logo":{"light":"https://mintcdn.com/pingmee/6-cSiE-VJQ-upKI2/logo/light.svg?fit=max\u0026auto=format\u0026n=6-cSiE-VJQ-upKI2\u0026q=85\u0026s=d9da227b37f163e6cb4e93227d0c1f9e","dark":"https://mintcdn.com/pingmee/6-cSiE-VJQ-upKI2/logo/dark.svg?fit=max\u0026auto=format\u0026n=6-cSiE-VJQ-upKI2\u0026q=85\u0026s=52c428147e8593e20587c84e1bb2cf18"},"favicon":"https://mintcdn.com/pingmee/6GqCW7N1hw98BUFa/favicon.ico?fit=max\u0026auto=format\u0026n=6GqCW7N1hw98BUFa\u0026q=85\u0026s=25d96fcd788b73f6390cf36f937cbde7","navbar":{"links":[{"href":"mailto:support@pingmee.co.il","label":"Support"}],"primary":{"type":"button","label":"Home","href":"https://pingmee.co.il"}},"footer":{"socials":{"facebook":"https://www.facebook.com/profile.php?id=61573401389848","instagram":"https://www.instagram.com/pingmee_ai","linkedin":"https://www.linkedin.com/company/pingmee-chat"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"metadata":{"timestamp":true},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Updates","icon":"newspaper","href":"https://pingmee.co.il/updates/"},{"anchor":"Academy","icon":"newspaper","href":"https://pingmee.co.il/academy/"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"pingmee","hasAudioNarration":false,"actualSubdomain":"pingmee","customDomains":["docs.pingmee.co.il"],"gitSource":{"type":"github","owner":"apsoftwareservice","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ada59ec188562674795c2ac","collectionId":"35a353a6-0993-410b-a7f5-dcf303b663d8","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ada59ec188562674795c2ac"},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6ada59ec188562674795c2ac","clientVersion":"0.0.3990","searchFilterCounts":[{"language":"default","tag":"API reference","count":43},{"language":"default","tag":"Workflows","count":18},{"language":"default","tag":"Guides","count":11},{"language":"default","tag":"Conversation","count":9},{"language":"default","tag":"Tasks","count":7},{"language":"default","tag":"API","count":7},{"language":"default","tag":"Customers","count":5},{"language":"default","tag":"Tags","count":4},{"language":"default","tag":"AI Agents","count":3},{"language":"default","tag":"Campaigns","count":3}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","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":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","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":"per-site-search-delta","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":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","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":"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":"byok-sep-25","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":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","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":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/business/get-phone-numbers","slug":"/api-reference/business/get-phone-numbers","pageMetadata":{"title":"Get Phone Numbers","openapi":"GET /phone-numbers","lastUpdatedDate":"2026-09-04","timestamp":true,"description":"List connected WhatsApp phone numbers for the authenticated business. Call this before creating a workflow: if more than one number is returned, ask the user which one to bind. Copy the chosen row's `id` into the workflow `associatedToBusinessId` (not `associatedBusinessId`, which is the WABA id) and set `platformType`. For a starter/outbound bot (or a named catalog template), pass the same `id` as `phoneNumberId` on GET `/templates`. Skip GET `/templates` for inbound reply bots (`pingmeeTrigger`) unless the user named a template. Facebook pages and Instagram accounts are not in this list. See `/build-workflows/document` (platform binding) and `/build-workflows/overview`.","href":"/api-reference/business/get-phone-numbers"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"List connected WhatsApp phone numbers for the authenticated business. Call this before creating a workflow: if more than one number is returned, ask the user which one to bind. Copy the chosen row’s \", _jsx(_components.code, {\n children: \"id\"\n }), \" into the workflow \", _jsx(_components.code, {\n children: \"associatedToBusinessId\"\n }), \" (not \", _jsx(_components.code, {\n children: \"associatedBusinessId\"\n }), \", which is the WABA id) and set \", _jsx(_components.code, {\n children: \"platformType\"\n }), \". For a starter/outbound bot (or a named catalog template), pass the same \", _jsx(_components.code, {\n children: \"id\"\n }), \" as \", _jsx(_components.code, {\n children: \"phoneNumberId\"\n }), \" on GET \", _jsx(_components.code, {\n children: \"/templates\"\n }), \". Skip GET \", _jsx(_components.code, {\n children: \"/templates\"\n }), \" for inbound reply bots (\", _jsx(_components.code, {\n children: \"pingmeeTrigger\"\n }), \") unless the user named a template. Facebook pages and Instagram accounts are not in this list. See \", _jsx(_components.code, {\n children: \"/build-workflows/document\"\n }), \" (platform binding) and \", _jsx(_components.code, {\n children: \"/build-workflows/overview\"\n }), \".\"]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,ol:`ol`,p:`p`,strong:`strong`,..._provideComponents(),...props.components};return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Connected WhatsApp numbers for the authenticated business. Use this `,_jsx(_components.strong,{children:`before creating a workflow`}),`.`]}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsx(_components.li,{children:`Call this endpoint.`}),`\n`,_jsxs(_components.li,{children:[`If `,_jsx(_components.code,{children:`phoneNumbers`}),` has more than one row, `,_jsx(_components.strong,{children:`ask the user`}),` which number the bot should send from.`]}),`\n`,_jsxs(_components.li,{children:[`Copy that row’s `,_jsx(_components.code,{children:`id`}),` into the workflow’s `,_jsx(_components.code,{children:`associatedToBusinessId`}),` and set `,_jsx(_components.code,{children:`platformType`}),` to `,_jsx(_components.code,{children:`whatsapp`}),`. Do `,_jsx(_components.strong,{children:`not`}),` use `,_jsx(_components.code,{children:`associatedBusinessId`}),` (that is the WABA id).`]}),`\n`,_jsxs(_components.li,{children:[`For a `,_jsx(_components.strong,{children:`starter`}),` / outbound bot (or a named catalog template), pass the same `,_jsx(_components.code,{children:`id`}),` as `,_jsx(_components.code,{children:`phoneNumberId`}),` when `,_jsx(_components.a,{href:`/api-reference/business/get-templates`,children:`fetching templates`}),`. Skip GET `,_jsx(_components.code,{children:`/templates`}),` for inbound reply bots unless the user named a template.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`See `,_jsx(_components.a,{href:`/build-workflows/document#platform-binding`,children:`Platform binding`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`This list does `,_jsx(_components.strong,{children:`not`}),` include Facebook pages or Instagram accounts. There is no public list-pages API.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Get Phone Numbers","openapi":"GET /phone-numbers","lastUpdatedDate":"2026-09-04","timestamp":true,"description":"List connected WhatsApp phone numbers for the authenticated business. Call this before creating a workflow: if more than one number is returned, ask the user which one to bind. Copy the chosen row's `id` into the workflow `associatedToBusinessId` (not `associatedBusinessId`, which is the WABA id) and set `platformType`. For a starter/outbound bot (or a named catalog template), pass the same `id` as `phoneNumberId` on GET `/templates`. Skip GET `/templates` for inbound reply bots (`pingmeeTrigger`) unless the user named a template. Facebook pages and Instagram accounts are not in this list. See `/build-workflows/document` (platform binding) and `/build-workflows/overview`.","href":"/api-reference/business/get-phone-numbers"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"description":"List connected WhatsApp phone numbers for the authenticated business. Call this before creating a workflow: if more than one number is returned, ask the user which one to bind. Copy the chosen row's `id` into the workflow `associatedToBusinessId` (not `associatedBusinessId`, which is the WABA id) and set `platformType`. For a starter/outbound bot (or a named catalog template), pass the same `id` as `phoneNumberId` on GET `/templates`. Skip GET `/templates` for inbound reply bots (`pingmeeTrigger`) unless the user named a template. Facebook pages and Instagram accounts are not in this list. See `/build-workflows/document` (platform binding) and `/build-workflows/overview`.","responses":{"200":"c6feb0d5-0276-4633-88e3-1876d05cf10a","401":"b170c64d-6c9d-47b1-88ea-f2f2be737d31"},"x-mint":{"mcp":{"enabled":true,"name":"get-phone-numbers","description":"List connected WhatsApp phone numbers. Ask the user which number to bind, then set workflow associatedToBusinessId to the row id (not associatedBusinessId / WABA). Use that id as phoneNumberId on GET /templates only for starter/outbound bots or a named catalog template — not for inbound reply bots."}},"method":"get","type":"path","servers":["8f748d62-b54a-43df-bc3f-8455e962b478"],"security":["8479c3ab-4b29-47c5-aaba-8cb2a1514c75"],"path":"/phone-numbers","baseUrlOptions":["https://business.pingmee.co.il"],"title":"","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"responses":{"c6feb0d5-0276-4633-88e3-1876d05cf10a":{"description":"Connected phone numbers","content":{"application/json":{"schema":{"type":"object","properties":{"phoneNumbers":{"type":"array","description":"Connected WhatsApp numbers. Use `id` as workflow `associatedToBusinessId`.","items":{"type":"object","properties":{"id":{"type":"string","description":"Phone-number id. Copy this into workflow `associatedToBusinessId` and into GET `/templates?phoneNumberId=`.","uniqueKey":"phoneNumbers.items.[INDEX].id","typeLabel":"string"},"verified_name":{"type":"string","description":"Verified business name. Show this when asking the user to pick a number.","uniqueKey":"phoneNumbers.items.[INDEX].verified_name","typeLabel":"string"},"display_phone_number":{"type":"string","description":"Display phone number (human-readable). Not the workflow id.","uniqueKey":"phoneNumbers.items.[INDEX].display_phone_number","typeLabel":"string"},"type":{"type":"string","description":"`whatsapp`. Copy into workflow `platformType`.","uniqueKey":"phoneNumbers.items.[INDEX].type","typeLabel":"string"},"associatedBusinessId":{"type":"string","description":"WhatsApp Business Account (WABA) id. Do not put this in `associatedToBusinessId`.","uniqueKey":"phoneNumbers.items.[INDEX].associatedBusinessId","typeLabel":"string"}},"additionalProperties":true,"uniqueKey":"phoneNumbers.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"phoneNumbers","typeLabel":"object[]"}},"required":["phoneNumbers"],"additionalProperties":true,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"phoneNumbers":[{"id":"\u003cstring>","verified_name":"\u003cstring>","display_phone_number":"\u003cstring>","type":"\u003cstring>","associatedBusinessId":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"b170c64d-6c9d-47b1-88ea-f2f2be737d31":{"description":"Unauthorized","content":{"application/json":{"schema":{"required":["error","message"],"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","message":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"8479c3ab-4b29-47c5-aaba-8cb2a1514c75":{"cookieAuth":{"type":"apiKey","in":"header","name":"Cookie","description":"Personal access token from Pingmee Settings → Developer Tools","scopes":[],"schemeName":"cookieAuth"},"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","description":"Business API key from Pingmee Settings → Developer Tools","scopes":[],"schemeName":"ApiKeyAuth"}}},"servers":{"8f748d62-b54a-43df-bc3f-8455e962b478":{"url":"https://business.pingmee.co.il","description":"Business phone numbers service"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"Cookie","description":"Personal access token from Pingmee Settings → Developer Tools","scopes":[],"schemeName":"cookieAuth"},"schema":{"title":"Cookie","type":"string","description":"Personal access token from Pingmee Settings → Developer Tools","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"cookieAuth","name":"Cookie"},{"scheme":{"type":"apiKey","in":"header","name":"x-api-key","description":"Business API key from Pingmee Settings → Developer Tools","scopes":[],"schemeName":"ApiKeyAuth"},"schema":{"title":"x-api-key","type":"string","description":"Business API key from Pingmee Settings → Developer Tools","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKeyAuth","name":"x-api-key"}],"title":"cookieAuth \u0026 ApiKeyAuth"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"pingmee","siteName":"Pingmee","title":"Get Phone Numbers - Pingmee","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-22T18:46:27.134Z","gitLastModified":"2026-10-22T18:24:48.000Z","originalFileLocation":"api-reference/business/get-phone-numbers.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"List connected WhatsApp phone numbers for the authenticated business. Call this before creating a workflow: if more than one number is returned, ask the user which one to bind. Copy the chosen row\u0026#x27;s id into the workflow associatedToBusinessId (not associatedBusinessId, which is the WABA id) and set platformType. For a starter/outbound bot (or a named catalog template), pass the same id as phoneNumberId on GET /templates. Skip GET /templates for inbound reply bots (pingmeeTrigger) unless the user named a template. Facebook pages and Instagram accounts are not in this list. See /build-workflows/document (platform binding) and /build-workflows/overview.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Pingmee\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/pingmee/1TKPNPCBCRVoPdBm/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/pingmee/1TKPNPCBCRVoPdBm/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/pingmee/1TKPNPCBCRVoPdBm/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/pingmee/1TKPNPCBCRVoPdBm/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/pingmee/1TKPNPCBCRVoPdBm/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/pingmee/1TKPNPCBCRVoPdBm/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/pingmee/1TKPNPCBCRVoPdBm/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/pingmee/1TKPNPCBCRVoPdBm/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/pingmee/1TKPNPCBCRVoPdBm/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get Phone Numbers - Pingmee\">\u003cmeta data-mint-head property=\"og:description\" content=\"List connected WhatsApp phone numbers for the authenticated business. Call this before creating a workflow: if more than one number is returned, ask the user which one to bind. Copy the chosen row\u0026#x27;s id into the workflow associatedToBusinessId (not associatedBusinessId, which is the WABA id) and set platformType. For a starter/outbound bot (or a named catalog template), pass the same id as phoneNumberId on GET /templates. Skip GET /templates for inbound reply bots (pingmeeTrigger) unless the user named a template. Facebook pages and Instagram accounts are not in this list. See /build-workflows/document (platform binding) and /build-workflows/overview.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Pingmee\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.pingmee.co.il/api-reference/business/get-phone-numbers\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://pingmee.mintlify.app/_mintlify/api/og/v2?division=Misc\u0026amp;title=Get+Phone+Numbers\u0026amp;description=List+connected+WhatsApp+phone+numbers+for+the+authenticated+business.+Call+this+before+creating+a+workflow%3A+if+more+than+one+number+is+returned%2C+ask+the+user+wh\u0026amp;theme=f5e70bc7afe80f23daa3ecc1\u0026amp;signature=5174c025aa6e9f8fbec825f3d3db99849a08f2b19b252e50aeb2ef552beff7da\">\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=\"Get Phone Numbers - Pingmee\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"List connected WhatsApp phone numbers for the authenticated business. Call this before creating a workflow: if more than one number is returned, ask the user which one to bind. Copy the chosen row\u0026#x27;s id into the workflow associatedToBusinessId (not associatedBusinessId, which is the WABA id) and set platformType. For a starter/outbound bot (or a named catalog template), pass the same id as phoneNumberId on GET /templates. Skip GET /templates for inbound reply bots (pingmeeTrigger) unless the user named a template. Facebook pages and Instagram accounts are not in this list. See /build-workflows/document (platform binding) and /build-workflows/overview.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://pingmee.mintlify.app/_mintlify/api/og/v2?division=Misc\u0026amp;title=Get+Phone+Numbers\u0026amp;description=List+connected+WhatsApp+phone+numbers+for+the+authenticated+business.+Call+this+before+creating+a+workflow%3A+if+more+than+one+number+is+returned%2C+ask+the+user+wh\u0026amp;theme=f5e70bc7afe80f23daa3ecc1\u0026amp;signature=5174c025aa6e9f8fbec825f3d3db99849a08f2b19b252e50aeb2ef552beff7da\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/pingmee/1TKPNPCBCRVoPdBm/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Pingmee\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#16A34A\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.pingmee.co.il/api-reference/business/get-phone-numbers\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/business/get-phone-numbers.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.pingmee.co.il/#organization\",\"name\":\"Pingmee\",\"url\":\"https://docs.pingmee.co.il\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/pingmee/6-cSiE-VJQ-upKI2/logo/light.svg?fit=max\u0026auto=format\u0026n=6-cSiE-VJQ-upKI2\u0026q=85\u0026s=d9da227b37f163e6cb4e93227d0c1f9e\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.pingmee.co.il#website\",\"name\":\"Pingmee\",\"url\":\"https://docs.pingmee.co.il\",\"publisher\":{\"@id\":\"https://docs.pingmee.co.il/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.pingmee.co.il/api-reference/business/get-phone-numbers#webpage\",\"url\":\"https://docs.pingmee.co.il/api-reference/business/get-phone-numbers\",\"name\":\"Get Phone Numbers\",\"description\":\"List connected WhatsApp phone numbers for the authenticated business. Call this before creating a workflow: if more than one number is returned, ask the user which one to bind. Copy the chosen row's id into the workflow associatedToBusinessId (not associatedBusinessId, which is the WABA id) and set platformType. For a starter/outbound bot (or a named catalog template), pass the same id as phoneNumberId on GET /templates. Skip GET /templates for inbound reply bots (pingmeeTrigger) unless the user named a template. Facebook pages and Instagram accounts are not in this list. See /build-workflows/document (platform binding) and /build-workflows/overview.\",\"dateModified\":\"2026-09-04T00:00:00.000Z\",\"isPartOf\":{\"@id\":\"https://docs.pingmee.co.il#website\"},\"breadcrumb\":{\"@id\":\"https://docs.pingmee.co.il/api-reference/business/get-phone-numbers#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.pingmee.co.il/api-reference/business/get-phone-numbers#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Pingmee\",\"item\":\"https://docs.pingmee.co.il\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get Phone Numbers\",\"item\":\"https://docs.pingmee.co.il/api-reference/business/get-phone-numbers\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.pingmee.co.il/api-reference/business/get-phone-numbers#apireference\",\"headline\":\"Get Phone Numbers\",\"name\":\"Get Phone Numbers\",\"description\":\"List connected WhatsApp phone numbers for the authenticated business. Call this before creating a workflow: if more than one number is returned, ask the user which one to bind. Copy the chosen row's id into the workflow associatedToBusinessId (not associatedBusinessId, which is the WABA id) and set platformType. For a starter/outbound bot (or a named catalog template), pass the same id as phoneNumberId on GET /templates. Skip GET /templates for inbound reply bots (pingmeeTrigger) unless the user named a template. Facebook pages and Instagram accounts are not in this list. See /build-workflows/document (platform binding) and /build-workflows/overview.\",\"url\":\"https://docs.pingmee.co.il/api-reference/business/get-phone-numbers\",\"mainEntityOfPage\":{\"@id\":\"https://docs.pingmee.co.il/api-reference/business/get-phone-numbers#webpage\"},\"dateModified\":\"2026-09-04T00:00:00.000Z\",\"publisher\":{\"@id\":\"https://docs.pingmee.co.il/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.pingmee.co.il#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Pingmee\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Pingmee","nav":{"global":{"anchors":[{"anchor":"Updates","icon":"newspaper","href":"https://pingmee.co.il/updates/"},{"anchor":"Academy","icon":"newspaper","href":"https://pingmee.co.il/academy/"}]},"tabs":[{"tab":"API reference","groups":[{"group":"API documentation","pages":[{"title":"Introduction","href":""}]},{"group":"Messages","pages":[{"title":"Send Message","openapi":"POST /sendMessage","href":"/api-reference/messages/send-message"},{"title":"Send Template","openapi":"POST /templates/send","href":"/api-reference/messages/send-template"},{"title":"Get Messages","openapi":"POST /getMessages","href":"/api-reference/messages/get-messages"}]},{"group":"Conversation","pages":[{"title":"Get Conversations","openapi":"POST /conversations","href":"/api-reference/conversation/get-all"},{"title":"Get Conversation","openapi":"GET /conversations/{id}","href":"/api-reference/conversation/get"},{"title":"Set Status","openapi":"POST /conversations/{id}/status","href":"/api-reference/conversation/status"},{"title":"Set Answer Mode","openapi":"POST /conversations/{id}/answer-mode","href":"/api-reference/conversation/answer-mode"},{"title":"Get Conversation Tags","openapi":"GET /conversations/{id}/tags","href":"/api-reference/conversation/tags-get"},{"title":"Assign Tags to Conversation","openapi":"POST /conversations/{id}/tags","href":"/api-reference/conversation/tags-assign"},{"title":"Remove Tags from Conversation","openapi":"DELETE /conversations/{id}/tags","href":"/api-reference/conversation/tags-remove"},{"title":"Assign Agents","openapi":"POST /conversations/{id}/agents","href":"/api-reference/conversation/agents/assign"},{"title":"Unassign Agents","openapi":"DELETE /conversations/{id}/agents","description":"Remove agents from a conversation. Path `id` is the conversation `participantsIdentifiers` (URL-encoded).","href":"/api-reference/conversation/agents/unassign"}]},{"group":"Misc","pages":[{"title":"Get Phone Numbers","openapi":"GET /phone-numbers","href":"/api-reference/business/get-phone-numbers"},{"title":"Get WhatsApp Templates","openapi":"GET /templates","description":"List WhatsApp message templates for a connected phone number (`type=whatsapp` and `phoneNumberId` required). `phoneNumberId` is the workflow `associatedToBusinessId` (GET `/phone-numbers` row `id`). Call this for **starter/outbound** bots (`workflowTrigger`, POST `/workflows/{id}/trigger`, campaign-style send, or any send outside the 24-hour window), or when the user named a catalog template. Do **not** call this for inbound reply bots (`pingmeeTrigger` `Messages Created` / `New Conversation Started`) — those use `messageType: custom`. When you do fetch: pick an APPROVED template, copy it into the WhatsApp node's `templateInformation`, set `messageType: template` and `templateType: whatsapp`, and bind `bodyVariables` / `headerVariables`. Skip IMAGE / VIDEO / DOCUMENT header templates unless `attachmentS3Id` is already on the component — there is no public upload API. Infer intent: `/build-workflows/overview`. Field mapping: `/build-workflows/nodes-and-edges`.","href":"/api-reference/business/get-templates"}]},{"group":"Webhooks","pages":[{"title":"Get Webhooks","openapi":"GET /webhook","href":"/api-reference/webhook/get"},{"title":"Create Webhook","openapi":"POST /webhook","href":"/api-reference/webhook/create"},{"title":"Delete Webhook","openapi":"DELETE /webhook/{webhookId}","href":"/api-reference/webhook/delete"}]},{"group":"Tags","pages":[{"title":"Get Tags","openapi":"GET /conversation/tags","href":"/api-reference/tags/get-all"},{"title":"Get Tag","openapi":"GET /conversation/tags/{id}","href":"/api-reference/tags/get"},{"title":"Create Tag","openapi":"PUT /conversation/tags","href":"/api-reference/tags/create"},{"title":"Delete Tag","openapi":"DELETE /conversation/tags/{id}","href":"/api-reference/tags/delete"}]},{"group":"Statuses","pages":[{"title":"Get Conversation Statuses","openapi":"GET /conversation/statuses","href":"/api-reference/conversation/statuses-get-all"},{"title":"Get Task Statuses","openapi":"GET /tasks/statuses","href":"/api-reference/tasks/statuses-get-all"},{"title":"Create Task Status","openapi":"PUT /tasks/status","href":"/api-reference/tasks/statuses-create"},{"title":"Delete Task Status","openapi":"DELETE /tasks/status/{id}","href":"/api-reference/tasks/statuses-delete"}]},{"group":"Agents","pages":[{"title":"Get Agents","openapi":"GET /agents","href":"/api-reference/conversation/agents/get-all"},{"title":"Get Agent","openapi":"GET /agents/{id}","href":"/api-reference/conversation/agents/get"}]},{"group":"AI Agents","pages":[{"title":"Get AI Agents","openapi":"GET /ai-agents","href":"/api-reference/ai-agents/get-all"},{"title":"Get AI Agent","openapi":"GET /ai-agents/{id}","href":"/api-reference/ai-agents/get"},{"title":"Update AI Agent","openapi":"PUT /ai-agents/{id}","href":"/api-reference/ai-agents/update"}]},{"group":"Customers","pages":[{"title":"Get Customers","openapi":"POST /customers","href":"/api-reference/customers/get-all"},{"title":"Get Customer","openapi":"GET /customers/{id}","href":"/api-reference/customers/get"},{"title":"Create Customers","openapi":"PUT /customers","href":"/api-reference/customers/create"},{"title":"Update Customer","openapi":"POST /customers/{id}","href":"/api-reference/customers/update"},{"title":"Delete Customer","openapi":"DELETE /customers/{id}","href":"/api-reference/customers/delete"}]},{"group":"Campaigns","pages":[{"title":"Get Campaign","openapi":"GET /campaigns/{id}","href":"/api-reference/campaigns/get"},{"title":"Create Campaign","openapi":"POST /campaigns","href":"/api-reference/campaigns/create"},{"title":"Delete Campaign","openapi":"DELETE /campaigns/{id}","href":"/api-reference/campaigns/delete"}]},{"group":"Tasks","pages":[{"title":"Get Tasks","openapi":"POST /tasks/list","href":"/api-reference/tasks/get-all"},{"title":"Get Task","openapi":"GET /tasks/{taskId}","href":"/api-reference/tasks/get"},{"title":"Update Task","openapi":"PATCH /tasks/{taskId}","href":"/api-reference/tasks/update"},{"title":"Delete Task","openapi":"DELETE /tasks/{taskId}","href":"/api-reference/tasks/delete"},{"title":"Get Task Statuses","openapi":"GET /tasks/statuses","href":"/api-reference/tasks/statuses-get-all"},{"title":"Create Task Status","openapi":"PUT /tasks/status","href":"/api-reference/tasks/statuses-create"},{"title":"Delete Task Status","openapi":"DELETE /tasks/status/{id}","href":"/api-reference/tasks/statuses-delete"}]}]},{"tab":"Workflows","pages":[{"title":"Workflows","href":"/workflows-documentation"}]},{"tab":"Make","pages":[{"title":"Make","href":"/make"}]},{"tab":"n8n","pages":[{"title":"n8n","href":"/n8n"}]}]},"title":"Get Phone Numbers - Pingmee","buildId":"dpl_2oYXwqkEXirXBPk8wV1FtM5USFWi","deploymentId":"dpl_2oYXwqkEXirXBPk8wV1FtM5USFWi","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-WRhTSUDL.js","utils-ChMov4Kr.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-_REmC2bI.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Bp6nVRCu.js","snippetPresets-DZadmXoU.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CY2WdoTl.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-DwYG-Q4l.js","shallow-BXQIGwv4.js","getApiPlaygroundDisplay-CK5nK5B9.js","CodeSnippet-TH4a2aGW.js","CodeSnippets-DwsQiOFS.js","Page-R3M_BF4L.js","getPastedJson-DD7kUzi_.js","icon-holE3QoJ.js","MethodPill-DUW0T8us.js","DuplicateIcon-CI_p4be-.js","createIcon-BdbRvavb.js","DynamicMarkdown-DN96a4Ur.js","SectionHeading-SCu36A9d.js","axios-vUo_bRtp.js","Markdown-CCeGv-zI.js","clsx-BGBGWFTt.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-Cv_O2fky.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-2C5OB2eV.js"]}