The ID of the linked agent, if the phone number is linked to one.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Vogent","colors":{"primary":"#1E4CFE","light":"#5476FF","dark":"#1E4CFE"},"logo":{"light":"https://mintcdn.com/elto-1/ooEImm5m-H0BmxUg/logo/light.svg?fit=max\u0026auto=format\u0026n=ooEImm5m-H0BmxUg\u0026q=85\u0026s=4bdeb0d3b2f061ef727c095d1cbccfeb","dark":"https://mintcdn.com/elto-1/ooEImm5m-H0BmxUg/logo/dark.svg?fit=max\u0026auto=format\u0026n=ooEImm5m-H0BmxUg\u0026q=85\u0026s=9cb454e44058d36d3032ca5b13a24149"},"favicon":"https://mintcdn.com/elto-1/ooEImm5m-H0BmxUg/favicon.svg?fit=max\u0026auto=format\u0026n=ooEImm5m-H0BmxUg\u0026q=85\u0026s=fe8097933a06b6ccbc33f7a037cdfc12","api":{"mdx":{"auth":{"method":"bearer"}}},"navbar":{"links":[{"href":"mailto:jagath@vogent.ai","label":"Support"},{"href":"https://discord.gg/An5z6xhYfS","label":"Discord"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.vogent.ai"}},"footer":{"socials":{"twitter":"https://x.com/vogentai","linkedin":"https://www.linkedin.com/company/vogent","discord":"https://discord.gg/An5z6xhYfS"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"elto-1","hasAudioNarration":false,"actualSubdomain":"elto-1","customDomains":["docs.vogent.ai"],"gitSource":{"type":"github","owner":"elto-docs","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{},"buildId":"6a9090481fe68a4588ff7384","clientVersion":"0.0.4088","searchFilterCounts":[{"language":"default","tag":"API Reference","count":57},{"language":"default","tag":"Guides","count":50},{"language":"default","tag":"Platform Overview","count":26},{"language":"default","tag":"Agents","count":18},{"language":"default","tag":"Voicelab","count":17},{"language":"default","tag":"Phone Numbers","count":13},{"language":"default","tag":"For Developers","count":10},{"language":"default","tag":"Eval Runs","count":7},{"language":"default","tag":"Batch Dials","count":7},{"language":"default","tag":"Webhooks","count":7}]},"assistantConfig":{},"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":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/create-number","slug":"/api-reference/create-number","pageMetadata":{"openapi":"post /phone_numbers","title":"Create a phone number","description":"Creates a phone number of various types (purchase, SIP import, or Vogent SIP).","href":"/api-reference/create-number"},"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: \"Creates a phone number of various types (purchase, SIP import, or Vogent SIP).\"\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}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}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":{"openapi":"post /phone_numbers","title":"Create a phone number","description":"Creates a phone number of various types (purchase, SIP import, or Vogent SIP).","href":"/api-reference/create-number"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Create a phone number","description":"Creates a phone number of various types (purchase, SIP import, or Vogent SIP).","operationId":"createPhoneNumber","requestBody":"7a1b8da5-3863-447f-abba-6dd00e1f8a75","responses":{"200":"685ded3d-fcd7-49c4-a024-9eadeaa3d148","400":"1046c057-8c27-44ad-b026-5d36f3abafc1","422":"ea34cc79-9adc-4e0e-be6d-66a0c193aca0"},"method":"post","type":"path","servers":["b09f045b-12f8-4298-8576-2f7cd9d22cec"],"security":["02d4cac2-c08d-4613-ad1d-fdfdb10be0db"],"path":"/phone_numbers","baseUrlOptions":["https://api.vogent.ai/api"],"title":"Create a phone number","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"description":"Create a new phone number","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","enum":["purchase","sip_import","vogent_sip"],"description":"The type of phone number creation operation.","nullable":false,"isRequired":true,"uniqueKey":"type","typeLabel":"enum\u003cstring>"},"purchase":{"oneOf":[{"type":"object","properties":{"number":{"type":"string","description":"The number as returned by the phone number search endpoint.","nullable":false,"isRequired":true,"uniqueKey":"purchase.oneOf.0.number","typeLabel":"string"}},"required":["number"],"description":"Required when type is 'purchase'.","uniqueKey":"purchase.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"number":{"type":"string","description":"The number as returned by the phone number search endpoint.","nullable":false}},"required":["number"],"description":"Required when type is 'purchase'.","uniqueKey":"purchase.oneOf.1","typeLabel":"null"}],"uniqueKey":"purchase","typeLabel":"object | null"},"sipImport":{"oneOf":[{"type":"object","properties":{"phoneNumber":{"type":"string","description":"The phone number in E.164 format.","nullable":false,"isRequired":true,"uniqueKey":"sipImport.oneOf.0.phoneNumber","typeLabel":"string"},"terminationUri":{"type":"string","description":"The termination URI for the SIP trunk.","nullable":false,"isRequired":true,"uniqueKey":"sipImport.oneOf.0.terminationUri","typeLabel":"string"},"username":{"type":"string","description":"The username for SIP authentication.","nullable":false,"isRequired":true,"uniqueKey":"sipImport.oneOf.0.username","typeLabel":"string"},"password":{"type":"string","description":"The password for SIP authentication.","nullable":false,"isRequired":true,"uniqueKey":"sipImport.oneOf.0.password","typeLabel":"string"}},"required":["phoneNumber","terminationUri","username","password"],"description":"Required when type is 'sip_import'.","uniqueKey":"sipImport.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"phoneNumber":{"type":"string","description":"The phone number in E.164 format.","nullable":false},"terminationUri":{"type":"string","description":"The termination URI for the SIP trunk.","nullable":false},"username":{"type":"string","description":"The username for SIP authentication.","nullable":false},"password":{"type":"string","description":"The password for SIP authentication.","nullable":false}},"required":["phoneNumber","terminationUri","username","password"],"description":"Required when type is 'sip_import'.","uniqueKey":"sipImport.oneOf.1","typeLabel":"null"}],"uniqueKey":"sipImport","typeLabel":"object | null"},"vogentSip":{"oneOf":[{"type":"object","properties":{"sipPrefix":{"type":"string","description":"The SIP prefix/username.","nullable":false,"isRequired":true,"uniqueKey":"vogentSip.oneOf.0.sipPrefix","typeLabel":"string"},"username":{"type":"string","description":"The username for SIP authentication (minimum 5 characters).","nullable":false,"isRequired":true,"uniqueKey":"vogentSip.oneOf.0.username","typeLabel":"string"},"password":{"type":"string","description":"The password for SIP authentication (minimum 5 characters).","nullable":false,"isRequired":true,"uniqueKey":"vogentSip.oneOf.0.password","typeLabel":"string"}},"required":["sipPrefix","username","password"],"description":"Required when type is 'vogent_sip'.","uniqueKey":"vogentSip.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"sipPrefix":{"type":"string","description":"The SIP prefix/username.","nullable":false},"username":{"type":"string","description":"The username for SIP authentication (minimum 5 characters).","nullable":false},"password":{"type":"string","description":"The password for SIP authentication (minimum 5 characters).","nullable":false}},"required":["sipPrefix","username","password"],"description":"Required when type is 'vogent_sip'.","uniqueKey":"vogentSip.oneOf.1","typeLabel":"null"}],"uniqueKey":"vogentSip","typeLabel":"object | null"}},"required":["type"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"purchase":{"number":"\u003cstring>"},"sipImport":{"phoneNumber":"\u003cstring>","terminationUri":"\u003cstring>","username":"\u003cstring>","password":"\u003cstring>"},"vogentSip":{"sipPrefix":"\u003cstring>","username":"\u003cstring>","password":"\u003cstring>"}}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"685ded3d-fcd7-49c4-a024-9eadeaa3d148":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"id","typeLabel":"string"},"number":{"type":"string","example":"+18001234567","description":"The number in e.164 format, or the SIP username, if the type is SIP_USERNAME.","isRequired":true,"uniqueKey":"number","typeLabel":"string"},"type":{"type":"string","enum":["PSTN","SIP_USERNAME"],"isRequired":true,"uniqueKey":"type","typeLabel":"enum\u003cstring>"},"agentId":{"oneOf":[{"type":"string","description":"The ID of the linked agent, if the phone number is linked to one.","isRequired":true,"uniqueKey":"agentId.oneOf.0","typeLabel":"string"},{"type":"null","description":"The ID of the linked agent, if the phone number is linked to one.","isRequired":true,"uniqueKey":"agentId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"agentId","typeLabel":"string | null"}},"required":["id","number","agentId","type"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"\u003cstring>","number":"+18001234567","type":"PSTN","agentId":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"1046c057-8c27-44ad-b026-5d36f3abafc1":{"description":"Invalid input","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"ea34cc79-9adc-4e0e-be6d-66a0c193aca0":{"description":"Validation exception","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{"02d4cac2-c08d-4613-ad1d-fdfdb10be0db":{"bearerAuth":{"type":"http","scheme":"bearer","description":"In the form `Bearer \u003capi_key_here>`. You can find your api key in your dashboard.","scopes":[]}}},"servers":{"b09f045b-12f8-4298-8576-2f7cd9d22cec":{"url":"https://api.vogent.ai/api"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"In the form `Bearer \u003capi_key_here>`. You can find your api key in your dashboard.","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"In the form `Bearer \u003capi_key_here>`. You can find your api key in your dashboard.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/openapi.yaml"},"subdomain":"elto-1","siteName":"Vogent","title":"Create a phone number - Vogent","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-08-27T19:30:16.672Z","originalFileLocation":"api-reference/create-number.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=\"Creates a phone number of various types (purchase, SIP import, or Vogent SIP).\">\u003cmeta data-mint-head name=\"application-name\" content=\"Vogent\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/elto-1/gR61agxbBlUmNgt_/_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/elto-1/gR61agxbBlUmNgt_/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/elto-1/gR61agxbBlUmNgt_/_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/elto-1/gR61agxbBlUmNgt_/_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/elto-1/gR61agxbBlUmNgt_/_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/elto-1/gR61agxbBlUmNgt_/_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/elto-1/gR61agxbBlUmNgt_/_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/elto-1/gR61agxbBlUmNgt_/_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/elto-1/gR61agxbBlUmNgt_/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create a phone number - Vogent\">\u003cmeta data-mint-head property=\"og:description\" content=\"Creates a phone number of various types (purchase, SIP import, or Vogent SIP).\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Vogent\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.vogent.ai/api-reference/create-number\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://elto-1.mintlify.site/_mintlify/api/og/v2?division=Phone+Numbers\u0026amp;title=Create+a+phone+number\u0026amp;description=Creates+a+phone+number+of+various+types+%28purchase%2C+SIP+import%2C+or+Vogent+SIP%29.\u0026amp;theme=6bdcd5822d317c01d3b7f839\u0026amp;signature=dd858b875181a6a01ce3dc51829ec673ff69d6c846ec7a6dd75dac10d871ceb1\">\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=\"Create a phone number - Vogent\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Creates a phone number of various types (purchase, SIP import, or Vogent SIP).\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://elto-1.mintlify.site/_mintlify/api/og/v2?division=Phone+Numbers\u0026amp;title=Create+a+phone+number\u0026amp;description=Creates+a+phone+number+of+various+types+%28purchase%2C+SIP+import%2C+or+Vogent+SIP%29.\u0026amp;theme=6bdcd5822d317c01d3b7f839\u0026amp;signature=dd858b875181a6a01ce3dc51829ec673ff69d6c846ec7a6dd75dac10d871ceb1\">\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/elto-1/gR61agxbBlUmNgt_/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Vogent\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#1E4CFE\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.vogent.ai/api-reference/create-number\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/create-number.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.vogent.ai/#organization\",\"name\":\"Vogent\",\"url\":\"https://docs.vogent.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/elto-1/ooEImm5m-H0BmxUg/logo/light.svg?fit=max\u0026auto=format\u0026n=ooEImm5m-H0BmxUg\u0026q=85\u0026s=4bdeb0d3b2f061ef727c095d1cbccfeb\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.vogent.ai#website\",\"name\":\"Vogent\",\"url\":\"https://docs.vogent.ai\",\"publisher\":{\"@id\":\"https://docs.vogent.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.vogent.ai/api-reference/create-number#webpage\",\"url\":\"https://docs.vogent.ai/api-reference/create-number\",\"name\":\"Create a phone number\",\"description\":\"Creates a phone number of various types (purchase, SIP import, or Vogent SIP).\",\"dateModified\":\"2026-08-27T19:30:16.672Z\",\"isPartOf\":{\"@id\":\"https://docs.vogent.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.vogent.ai/api-reference/create-number#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.vogent.ai/api-reference/create-number#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Phone Numbers\",\"item\":\"https://docs.vogent.ai/api-reference/list-phone-numbers\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create a phone number\",\"item\":\"https://docs.vogent.ai/api-reference/create-number\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.vogent.ai/api-reference/create-number#apireference\",\"headline\":\"Create a phone number\",\"name\":\"Create a phone number\",\"description\":\"Creates a phone number of various types (purchase, SIP import, or Vogent SIP).\",\"url\":\"https://docs.vogent.ai/api-reference/create-number\",\"mainEntityOfPage\":{\"@id\":\"https://docs.vogent.ai/api-reference/create-number#webpage\"},\"dateModified\":\"2026-08-27T19:30:16.672Z\",\"publisher\":{\"@id\":\"https://docs.vogent.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.vogent.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Vogent\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Vogent","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":"/introduction"}]},{"tab":"API Reference","groups":[{"group":"API Documentation","pages":[{"title":"Introduction","href":"/api-reference/introduction"}]},{"group":"Dials","pages":[{"openapi":"post /dials","title":"Create a new dial","href":"/api-reference/create-a-new-dial"},{"openapi":"post /dials/{id}/hangup","title":"Hangup Dial.","href":"/api-reference/hangup-dial"},{"openapi":"get /dials/{id}","title":"Get Dial","href":"/api-reference/get-dial"},{"openapi":"post /dials/{id}/token","title":"Get Dial Token","href":"/api-reference/get-dial-token"}]},{"group":"Agents","pages":[{"openapi":"get /agents","title":"List Agents","href":"/api-reference/list-agents"},{"openapi":"post /agents","title":"Create Agent","href":"/api-reference/create-agent"},{"openapi":"put /agents/{id}","title":"Update Agent","href":"/api-reference/update-agent"},{"openapi":"delete /agents/{id}","title":"Delete Agent","href":"/api-reference/delete-agent"}]},{"group":"Voices","pages":[{"openapi":"post /voices/clone","title":"Clone Voice","href":"/api-reference/clone-voice"},{"openapi":"get /voices","title":"List Voices","href":"/api-reference/list-voices"}]},{"group":"Versioned Prompts","pages":[{"openapi":"get /agents/{agentId}/versioned_prompts","title":"List versioned prompts","href":"/api-reference/list-versioned-prompts"},{"openapi":"get /agents/{agentId}/versioned_prompts/{id}","title":"Get versioned prompt","href":"/api-reference/get-versioned-prompt"},{"openapi":"put /agents/{agentId}/versioned_prompts/{id}","title":"Update versioned prompt","href":"/api-reference/update-versioned-prompt"},{"openapi":"post /agents/{agentId}/versioned_prompts","title":"Create versioned prompt","href":"/api-reference/create-versioned-prompt"}]},{"group":"Extractors","pages":[{"openapi":"get /agents/{agentId}/extractors/{extractorId}","title":"Get extractor","href":"/api-reference/get-extractor"},{"openapi":"get /agents/{agentId}/extractors","title":"List extractors","href":"/api-reference/list-extractors"},{"openapi":"post /agents/{agentId}/extractors","title":"Create extractor","href":"/api-reference/create-extractor"},{"openapi":"put /agents/{agentId}/extractors/{extractorId}","title":"Update extractor","href":"/api-reference/update-extractor"}]},{"group":"Phone Numbers","pages":[{"openapi":"get /phone_numbers","title":"List phone numbers","href":"/api-reference/list-phone-numbers"},{"openapi":"get /phone_numbers/{id}","title":"Get Phone Number","href":"/api-reference/get-phone-number"},{"openapi":"put /phone_numbers/{id}","title":"Update Phone Number","description":"Update a phone number's properties","href":"/api-reference/update-phone-number"},{"openapi":"post /phone_numbers","title":"Create a phone number","href":"/api-reference/create-number"},{"openapi":"post /phone_numbers/search","title":"Search for available numbers","description":"Search for available numbers available to purchase","href":"/api-reference/search-for-available-numbers"},{"openapi":"post /phone_numbers/purchase","title":"Purchase available number (deprecated, use /phone_numbers instead)","href":"/api-reference/purchase-available-number"},{"openapi":"delete /phone_numbers/{id}","title":"Delete Phone Number","href":"/api-reference/delete-phone-number"}]},{"group":"Functions","pages":[{"openapi":"post /functions","title":"Create a function","href":"/api-reference/create-a-function"},{"openapi":"get /functions/{id}","title":"Get function","href":"/api-reference/get-function"},{"openapi":"put /functions/{id}","title":"Update function","href":"/api-reference/update-function"},{"openapi":"delete /functions/{id}","title":"Delete function","href":"/api-reference/delete-function"}]},{"group":"Models","pages":[{"openapi":"get /models","title":"List Models","href":"/api-reference/list-models"}]},{"group":"Voicelab","pages":[{"openapi":"post /tts","title":"Run TTS Model","href":"/api-reference/run-tts-model"},{"openapi":"post /tts/multispeaker","title":"Run Multispeaker TTS Model","href":"/api-reference/run-multispeaker-tts-model"},{"title":"Websocket TTS","asyncapi":"api-reference/asyncapi.yaml channelOne","href":"/api-reference/voicelab-websocket-tts"}]},{"group":"Batch Dials","pages":[{"openapi":"get /batch_dial_jobs","title":"List Batch Jobs","href":"/api-reference/list-batch-dial-jobs"},{"openapi":"post /batch_dial_jobs","title":"Create Batch Job","href":"/api-reference/create-a-new-batch-dial-job"},{"openapi":"get /batch_dial_jobs/{id}","title":"Get Batch Job","href":"/api-reference/get-batch-dial-job"},{"openapi":"put /batch_dial_jobs/{id}","title":"Update Batch Job","href":"/api-reference/update-batch-dial-job"},{"openapi":"get /batch_dial_jobs/{id}/queue","title":"List Queued Batch Dials","href":"/api-reference/list-queued-dials-for-batch-dial-job"},{"openapi":"post /batch_dial_jobs/{id}/paused","title":"Pause/Resume Batch Job","href":"/api-reference/set-batch-dial-job-paused"},{"openapi":"get /batch_dial_jobs/{id}/dials","title":"List Batch Dials","href":"/api-reference/list-batch-dials"}]},{"group":"Eval Configs","pages":[{"openapi":"get /eval_configs","title":"List Eval Configs","href":"/api-reference/list-eval-configs"},{"openapi":"post /eval_configs","title":"Create Eval Config","href":"/api-reference/create-eval-config"},{"openapi":"get /eval_configs/{id}","title":"Get Eval Config","href":"/api-reference/get-eval-config"},{"openapi":"put /eval_configs/{id}","title":"Update Eval Config","href":"/api-reference/update-eval-config"}]},{"group":"Eval Records","pages":[{"openapi":"get /eval_configs/{id}/records","title":"List Eval Config Records","href":"/api-reference/list-eval-config-records"},{"openapi":"post /eval_configs/{id}/records","title":"Create Eval Config Record","href":"/api-reference/create-eval-config-record"},{"openapi":"get /eval_configs/{id}/records/{recordId}","title":"Get Eval Record","href":"/api-reference/get-eval-record"},{"openapi":"put /eval_configs/{id}/records/{recordId}","title":"Update Eval Record","href":"/api-reference/update-eval-record"},{"openapi":"delete /eval_configs/{id}/records/{recordId}","title":"Delete Eval Record","href":"/api-reference/delete-eval-record"}]},{"group":"Eval Runs","pages":[{"openapi":"get /eval_configs/{id}/runs","title":"List Eval Config Runs","href":"/api-reference/list-eval-config-runs"},{"openapi":"post /eval_configs/{id}/runs","title":"Run Eval","href":"/api-reference/run-eval"},{"openapi":"get /eval_runs/{id}","title":"Get Eval Run","href":"/api-reference/get-eval-run"},{"openapi":"get /eval_runs/{id}/results","title":"List Eval Run Results","href":"/api-reference/list-eval-run-results"},{"openapi":"get /eval_results/{id}","title":"Get Eval Result","href":"/api-reference/get-eval-result"},{"openapi":"post /eval_runs/{id}/cancel","title":"Cancel Eval Run","href":"/api-reference/cancel-eval-run"},{"openapi":"post /eval_results/{id}/rerun","title":"Rerun Eval Result","href":"/api-reference/rerun-eval-result"}]}]},{"tab":"SDK","pages":[{"title":"SDK","href":"/sdk/web-sdk"}]},{"tab":"Voicelab","pages":[{"title":"Voicelab","href":"/voicelab/introduction"}]}]},"basePath":"","title":"Create a phone number - Vogent","buildId":"dpl_DTau1J5HqS9UTgVSDwGksstFWtPa","deploymentId":"dpl_DTau1J5HqS9UTgVSDwGksstFWtPa","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-5FCzAcfS.js","utils-SLtAG4EZ.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-2DZi8ZMu.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-D7J3nkzE.js","snippetPresets-D0Alv0AH.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BI4qNJ2c.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BD3uyr8j.js","shallow-D8iEBr5z.js","getApiPlaygroundDisplay-CgNP4lzR.js","CodeSnippet-CX-QHuMs.js","CodeSnippets-VlXE-ZUf.js","Page-D9ithiIZ.js","getPastedJson-DYNQkZ1M.js","icon-CzacdwOi.js","MethodPill-2JVqoYKi.js","DuplicateIcon-_xVXs-U8.js","createIcon-BRHrweLo.js","DynamicMarkdown-mQG_iQiE.js","SectionHeading-DMpJzv8f.js","axios-vUo_bRtp.js","Markdown-5FGIym-8.js","clsx-D-TRO5q5.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CdrJecqK.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-CHlcWBLM.js"]}