Understand the monthly costs, per-minute rates, and credit usage for buying, porting, or bringing your own phone numbers into Thoughtly across all countries.
Understanding how phone number billing works on Thoughtly is important for managing your usage and costs.
Most standard phone numbers in the United States cost approximately 500 credits per month for AppSumo customers, or a comparable rate for other billing plans.
International phone numbers may have different pricing based on local regulations and carrier fees. You’ll see the exact cost when selecting a number during the purchase process.
For customers on AppSumo plans or credit-based billing, here’s how phone numbers consume credits:
Phone Numbers: 500 credits/month (US numbers)
Carrier Fees: 200 credits per dollar of fees incurred
Want to reduce your phone number costs? You can use the Bring Your Own Carrier (BYOC) feature to connect your own telephony provider and avoid carrier fees.
Here are some tips for managing your phone number costs:
Release unused numbers: If you’re no longer using a phone number, release it to avoid ongoing monthly charges.
Use call forwarding: Instead of purchasing multiple numbers, consider forwarding existing numbers to Thoughtly using our BYOC (Bring Your Own Carrier) feature.
Monitor your usage: Regularly check your billing dashboard to track phone number costs and overall credit consumption.
If you have questions about phone number billing or need help managing costs, contact our Support team at support@thoughtly.com.
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Thoughtly Docs","colors":{"primary":"#32CB08","light":"#72FA4C","dark":"#424242"},"logo":{"light":"https://mintcdn.com/thoughtly/SDuN6oJ1BG6zNAlA/images/logo/light.svg?fit=max\u0026auto=format\u0026n=SDuN6oJ1BG6zNAlA\u0026q=85\u0026s=4d3354db16ce0ed2172d34e5e8035572","dark":"https://mintcdn.com/thoughtly/SDuN6oJ1BG6zNAlA/images/logo/dark.svg?fit=max\u0026auto=format\u0026n=SDuN6oJ1BG6zNAlA\u0026q=85\u0026s=58a7238c8201f8aeffddfdc60c80dd8c"},"favicon":"https://mintcdn.com/thoughtly/SDuN6oJ1BG6zNAlA/images/logo/icon.svg?fit=max\u0026auto=format\u0026n=SDuN6oJ1BG6zNAlA\u0026q=85\u0026s=d50cd38bf5f4eb0a9448d1f0a514e9ff","api":{"openapi":"api-reference/openapi.json","mdx":{"server":"https://api.thoughtly.com"}},"navbar":{"links":[{"href":"https://docs.thoughtly.com/support/changelog","label":"Changelog"}],"primary":{"type":"button","label":"Get Started","href":"https://thought.ly/demo"}},"footer":{"socials":{"x":"https://twitter.com/thoughtlyai","linkedin":"https://www.linkedin.com/company/thoughtly-ai","instagram":"https://www.instagram.com/thoughtly.ai","slack":"https://community.thoughtly.com"}},"seo":{"metatags":{"og:type":"website","og:site_name":"Thoughtly Docs"},"indexing":"all"},"integrations":{"ga4":{"measurementId":"G-4JRQ329JCS"},"intercom":{"appId":"uii3kkuk"}},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Book a Demo","icon":"calendar","href":"https://thoughtly.com/demo"},{"anchor":"Platform Status","icon":"server","href":"https://status.thoughtly.com"},{"anchor":"Contact Support","icon":"life-ring","href":"mailto:support@thoughtly.com"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"thoughtly","hasAudioNarration":false,"actualSubdomain":"thoughtly","customDomains":["docs.thoughtly.com"],"gitSource":{"type":"github","owner":"thoughtlead-io","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ac7f6a1ac9242b21d007cf3","collectionId":"06667805-5409-4ece-914d-9ac093bcd250","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ac7f6a1ac9242b21d007cf3"},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6ac7f6a1ac9242b21d007cf3","clientVersion":"0.0.3966","searchFilterCounts":[{"language":"default","tag":"Documentation","count":92},{"language":"default","tag":"Promptbooks","count":50},{"language":"default","tag":"Integrations","count":31},{"language":"default","tag":"Resources","count":28},{"language":"default","tag":"Native Integrations","count":23},{"language":"default","tag":"Glossary","count":21},{"language":"default","tag":"Agents","count":17},{"language":"default","tag":"Platform","count":17},{"language":"default","tag":"API Reference","count":13},{"language":"default","tag":"Settings","count":10}]},"assistantConfig":{"enableAskAiButton":true,"enableStarterQuestions":true,"enableAskAiSearchBar":true,"deflection":{"enabled":true,"email":"support@thoughtly.com","showHelpButton":true}},"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":"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}],"starterQuestions":[{"_id":"690511b615e3c149686814cd","deploymentId":"6655d61f74c547ce373fda02","questionText":"How do I trigger an Automation using the API?","status":"active","generatedBy":"manual","createdAt":"2025-10-31T19:44:54.939Z","updatedAt":"2025-10-31T19:44:54.939Z","__v":0},{"_id":"690511ac15e3c14968681344","deploymentId":"6655d61f74c547ce373fda02","questionText":"What mid-call actions are available?","status":"active","generatedBy":"manual","createdAt":"2025-10-31T19:44:44.849Z","updatedAt":"2025-10-31T19:44:44.849Z","__v":0},{"_id":"690511a115e3c149686810f2","deploymentId":"6655d61f74c547ce373fda02","questionText":"How do I integrate Thoughtly with Salesforce?","status":"active","generatedBy":"manual","createdAt":"2025-10-31T19:44:33.341Z","updatedAt":"2025-10-31T19:44:33.341Z","__v":0}],"isAtlas":false,"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"#promptbookGrid{display:grid;grid-template-columns:1fr;gap:1.5rem;padding-top:2rem;padding-bottom:2rem}:root{--docs-image-radius:clamp(8px, 1vw + 4px, 12px)}.mdx-content img:not([src$=\".svg\"i]):not(.no-radius),img[src^=\"/images/\"]:not([src$=\".svg\"i]):not(.no-radius){border-radius:var(--docs-image-radius)!important}.mdx-content img.radius-sm{border-radius:6px}.mdx-content img.radius-lg{border-radius:16px}@media (min-width:640px){#promptbookGrid{grid-template-columns:repeat(2,1fr)}}@media (min-width:768px){#promptbookGrid{grid-template-columns:repeat(3,1fr)}}@media (min-width:1024px){#promptbookGrid{grid-template-columns:repeat(4,1fr)}}.responsive-promptbook-heading{display:flex;flex-direction:column;gap:1rem;align-items:flex-start;justify-content:flex-start;margin-top:1rem;margin-bottom:1rem}@media (min-width:768px){.responsive-promptbook-heading{flex-direction:row;align-items:center;justify-content:space-between}}.promptbook-card{box-shadow:0 0 10px rgba(0,0,0,.05)}.promptbook-card:hover{box-shadow:0 0 10px rgba(0,0,0,.2);scale:1.01;transition:all .3s ease}.promptbook-content{font-family:system-ui,sans-serif;color:#1f2937;line-height:1.7;max-width:100%;padding-bottom:2rem}.promptbook-content h1,.promptbook-content h2,.promptbook-content h3,.promptbook-content h4,.promptbook-content h5,.promptbook-content h6{font-weight:600;color:#111827;margin-top:2rem;margin-bottom:1rem;line-height:1.25}.promptbook-content h1{font-size:2rem}.promptbook-content h2{font-size:1.5rem}.promptbook-content h3{font-size:1.25rem}.promptbook-content h4{font-size:1.1rem}.promptbook-content h5{font-size:1rem}.promptbook-content h6{font-size:.95rem}.promptbook-content p{margin-top:1rem;margin-bottom:1rem}.promptbook-content strong{font-weight:600}.promptbook-content em{font-style:italic}.promptbook-content a{color:#32cb08;text-decoration:underline;transition:color .2s ease-in-out}.promptbook-content a:hover{color:#26a005}.promptbook-content ol,.promptbook-content ul{margin-top:1rem;margin-bottom:1rem;padding-left:1.5rem}.promptbook-content ul li::marker{color:#32cb08}.promptbook-content blockquote{border-left:4px solid #32cb08;padding-left:1rem;color:#6b7280;font-style:italic;margin:1.5rem 0}.promptbook-content pre{background-color:#f9fafb;color:#111827;padding:1rem;border-radius:6px;overflow-x:auto;margin:1.5rem 0}.promptbook-content code{background-color:#f3f4f6;padding:.2rem .4rem;border-radius:4px;font-size:.9em;font-family:monospace}.promptbook-content hr{border:0;border-top:1px solid #e5e7eb;margin:2rem 0}"}],"page":{"pagePath":"phone-number/billing-credits","slug":"/phone-number/billing-credits","pageMetadata":{"title":"Phone number billing and credits","description":"Understand the monthly costs, per-minute rates, and credit usage for buying, porting, or bringing your own phone numbers into Thoughtly across all countries.","href":"/phone-number/billing-credits"},"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: \"Understand the monthly costs, per-minute rates, and credit usage for buying, porting, or bringing your own phone numbers into Thoughtly across all countries.\"\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`,li:`li`,ol:`ol`,p:`p`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Heading,Tip}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Understanding how phone number billing works on Thoughtly is important for managing your usage and costs.`}),`\n`,_jsx(Heading,{level:`2`,id:`phone-number-costs`,children:`Phone Number Costs`}),`\n`,_jsx(_components.p,{children:`Phone numbers on Thoughtly are charged on a monthly basis. The cost varies depending on the country and type of number you purchase.`}),`\n`,_jsx(Heading,{level:`3`,id:`standard-phone-numbers`,children:`Standard Phone Numbers`}),`\n`,_jsxs(_components.p,{children:[`Most standard phone numbers in the United States cost approximately `,_jsx(_components.strong,{children:`500 credits per month`}),` for AppSumo customers, or a comparable rate for other billing plans.`]}),`\n`,_jsx(Heading,{level:`3`,id:`international-phone-numbers`,children:`International Phone Numbers`}),`\n`,_jsx(_components.p,{children:`International phone numbers may have different pricing based on local regulations and carrier fees. You’ll see the exact cost when selecting a number during the purchase process.`}),`\n`,_jsx(Heading,{level:`2`,id:`credit-consumption`,children:`Credit Consumption`}),`\n`,_jsx(_components.p,{children:`For customers on AppSumo plans or credit-based billing, here’s how phone numbers consume credits:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Phone Numbers`}),`: 500 credits/month (US numbers)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Carrier Fees`}),`: 200 credits per dollar of fees incurred`]}),`\n`]}),`\n`,_jsxs(Tip,{children:[`Want to reduce your phone number costs? You can use the `,_jsx(_components.a,{href:`/phone-number/byoc`,children:`Bring Your Own Carrier (BYOC)`}),` feature to connect your own telephony provider and avoid carrier fees.`]}),`\n`,_jsx(Heading,{level:`2`,id:`managing-phone-number-costs`,children:`Managing Phone Number Costs`}),`\n`,_jsx(_components.p,{children:`Here are some tips for managing your phone number costs:`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Release unused numbers`}),`: If you’re no longer using a phone number, release it to avoid ongoing monthly charges.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Use call forwarding`}),`: Instead of purchasing multiple numbers, consider forwarding existing numbers to Thoughtly using our `,_jsx(_components.a,{href:`/phone-number/byoc`,children:`BYOC (Bring Your Own Carrier)`}),` feature.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Monitor your usage`}),`: Regularly check your billing dashboard to track phone number costs and overall credit consumption.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`viewing-your-bill`,children:`Viewing Your Bill`}),`\n`,_jsx(_components.p,{children:`To view your phone number costs and overall billing information:`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`Navigate to `,_jsx(_components.a,{href:`/platform/settings/usage`,children:`Settings → Usage`}),` to see a breakdown of your phone number costs`]}),`\n`,_jsxs(_components.li,{children:[`View your subscription and payment details in `,_jsx(_components.a,{href:`/platform/settings/subscription`,children:`Settings → Subscription`})]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`For detailed information about Thoughtly’s billing system, visit our `,_jsx(_components.a,{href:`/platform/billing`,children:`Platform Billing`}),` documentation.`]}),`\n`,_jsx(Tip,{children:`Only Flex and Enterprise customers can purchase phone numbers from dashboard.`}),`\n`,_jsx(Heading,{level:`2`,id:`support`,children:`Support`}),`\n`,_jsxs(_components.p,{children:[`If you have questions about phone number billing or need help managing costs, contact our Support team at `,_jsx(_components.a,{href:`mailto:support@thoughtly.com`,children:`support@thoughtly.com`}),`.`]})]})}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":"Phone number billing and credits","description":"Understand the monthly costs, per-minute rates, and credit usage for buying, porting, or bringing your own phone numbers into Thoughtly across all countries.","href":"/phone-number/billing-credits"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Phone Number Costs","slug":"phone-number-costs","depth":2,"children":[{"title":"Standard Phone Numbers","slug":"standard-phone-numbers","depth":3,"children":[]},{"title":"International Phone Numbers","slug":"international-phone-numbers","depth":3,"children":[]}]},{"title":"Credit Consumption","slug":"credit-consumption","depth":2,"children":[]},{"title":"Managing Phone Number Costs","slug":"managing-phone-number-costs","depth":2,"children":[]},{"title":"Viewing Your Bill","slug":"viewing-your-bill","depth":2,"children":[]},{"title":"Support","slug":"support","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/thoughtly/79fc8fef0e90a20d/content/promptbook-scripts.js"],"subdomain":"thoughtly","siteName":"Thoughtly Docs","title":"Phone number billing and credits - Thoughtly Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-05-22T13:29:49.746Z","originalFileLocation":"phone-number/billing-credits.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=\"Understand the monthly costs, per-minute rates, and credit usage for buying, porting, or bringing your own phone numbers into Thoughtly across all countries.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Thoughtly Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/thoughtly/weHpxQJRTR6-Xzn6/_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/thoughtly/weHpxQJRTR6-Xzn6/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/thoughtly/weHpxQJRTR6-Xzn6/_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/thoughtly/weHpxQJRTR6-Xzn6/_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/thoughtly/weHpxQJRTR6-Xzn6/_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/thoughtly/weHpxQJRTR6-Xzn6/_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/thoughtly/weHpxQJRTR6-Xzn6/_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/thoughtly/weHpxQJRTR6-Xzn6/_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/thoughtly/weHpxQJRTR6-Xzn6/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Phone number billing and credits - Thoughtly Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Understand the monthly costs, per-minute rates, and credit usage for buying, porting, or bringing your own phone numbers into Thoughtly across all countries.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Thoughtly Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.thoughtly.com/phone-number/billing-credits\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://thoughtly.mintlify.app/_mintlify/api/og/v2?division=Phone+Numbers\u0026amp;title=Phone+number+billing+and+credits\u0026amp;description=Understand+the+monthly+costs%2C+per-minute+rates%2C+and+credit+usage+for+buying%2C+porting%2C+or+bringing+your+own+phone+numbers+into+Thoughtly+across+all+countries.\u0026amp;theme=6bdaf604450a94315e90f209\u0026amp;signature=bde24098978b826b05264fbffd88c82e6e263bd167b74bc7e3e8e26d90017073\">\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=\"Phone number billing and credits - Thoughtly Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Understand the monthly costs, per-minute rates, and credit usage for buying, porting, or bringing your own phone numbers into Thoughtly across all countries.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://thoughtly.mintlify.app/_mintlify/api/og/v2?division=Phone+Numbers\u0026amp;title=Phone+number+billing+and+credits\u0026amp;description=Understand+the+monthly+costs%2C+per-minute+rates%2C+and+credit+usage+for+buying%2C+porting%2C+or+bringing+your+own+phone+numbers+into+Thoughtly+across+all+countries.\u0026amp;theme=6bdaf604450a94315e90f209\u0026amp;signature=bde24098978b826b05264fbffd88c82e6e263bd167b74bc7e3e8e26d90017073\">\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/thoughtly/weHpxQJRTR6-Xzn6/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Thoughtly Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#32CB08\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.thoughtly.com/phone-number/billing-credits\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/phone-number/billing-credits.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.thoughtly.com/#organization\",\"name\":\"Thoughtly Docs\",\"url\":\"https://docs.thoughtly.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/thoughtly/SDuN6oJ1BG6zNAlA/images/logo/light.svg?fit=max\u0026auto=format\u0026n=SDuN6oJ1BG6zNAlA\u0026q=85\u0026s=4d3354db16ce0ed2172d34e5e8035572\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.thoughtly.com#website\",\"name\":\"Thoughtly Docs\",\"url\":\"https://docs.thoughtly.com\",\"publisher\":{\"@id\":\"https://docs.thoughtly.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.thoughtly.com/phone-number/billing-credits#webpage\",\"url\":\"https://docs.thoughtly.com/phone-number/billing-credits\",\"name\":\"Phone number billing and credits\",\"description\":\"Understand the monthly costs, per-minute rates, and credit usage for buying, porting, or bringing your own phone numbers into Thoughtly across all countries.\",\"dateModified\":\"2026-05-22T13:29:49.746Z\",\"isPartOf\":{\"@id\":\"https://docs.thoughtly.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.thoughtly.com/phone-number/billing-credits#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.thoughtly.com/phone-number/billing-credits#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Phone Numbers\",\"item\":\"https://docs.thoughtly.com/phone-number/getting-started\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Phone number billing and credits\",\"item\":\"https://docs.thoughtly.com/phone-number/billing-credits\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.thoughtly.com/phone-number/billing-credits#article\",\"headline\":\"Phone number billing and credits\",\"name\":\"Phone number billing and credits\",\"description\":\"Understand the monthly costs, per-minute rates, and credit usage for buying, porting, or bringing your own phone numbers into Thoughtly across all countries.\",\"url\":\"https://docs.thoughtly.com/phone-number/billing-credits\",\"mainEntityOfPage\":{\"@id\":\"https://docs.thoughtly.com/phone-number/billing-credits#webpage\"},\"dateModified\":\"2026-05-22T13:29:49.746Z\",\"publisher\":{\"@id\":\"https://docs.thoughtly.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.thoughtly.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Thoughtly Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Thoughtly Docs","nav":{"global":{"anchors":[{"anchor":"Book a Demo","icon":"calendar","href":"https://thoughtly.com/demo"},{"anchor":"Platform Status","icon":"server","href":"https://status.thoughtly.com"},{"anchor":"Contact Support","icon":"life-ring","href":"mailto:support@thoughtly.com"}]},"tabs":[{"tab":"Documentation","groups":[{"group":"Getting Started","icon":{"style":"light","name":"rocket"},"pages":[{"title":"Introduction to Thoughtly","href":"/getting-started/introduction"},{"title":"Quick start guide","href":"/getting-started/quick-start"},{"title":"Voice agent use cases and examples","href":"/getting-started/use-cases"},{"title":"Developer documentation","href":"/developers"}]},{"group":"Agents","icon":{"style":"light","name":"diagram-nested"},"pages":[{"title":"Agent Builder overview","href":"/agents/overview"},{"group":"Building","pages":[{"title":"Node types in the Agent Builder","href":"/agents/nodes"},{"title":"Outcomes and conversation branching","href":"/agents/outcomes"},{"title":"Variables in voice agents","href":"/agents/variables"},{"title":"Actions","href":"/agents/actions"},{"title":"Agent settings","href":"/agents/settings"},{"title":"Vibes AI assistant","href":"/agents/vibes-assistant"}]},{"group":"Voices","pages":[{"title":"Agent voices","href":"/agents/voices"},{"title":"Voice optimization for natural speech","href":"/agents/voice-optimization"},{"title":"Bring Your Own Key (BYOK) for voices","href":"/agents/voice-byok"},{"title":"Voice cloning for agents","href":"/agents/voice-cloning"}]},{"group":"Launch","pages":[{"title":"Test voice agents before launch","href":"/agents/testing"},{"title":"Voice agent tips and tricks","href":"/agents/tips-and-tricks"},{"title":"Deploy a voice agent","href":"/agents/deployment"}]},{"group":"Reference","pages":[{"title":"Troubleshoot Thoughtly voice agents","href":"/agents/troubleshooting"},{"title":"Call screening bypass","href":"/agents/call-screening-bypass"},{"title":"Migrate legacy agents to v1.8 Agent Builder","href":"/agents/migration-guide"}]}]},{"group":"Audiences","icon":{"style":"light","name":"users"},"pages":[{"title":"Audiences and contact management","href":"/platform/audiences"}]},{"group":"History","icon":{"style":"light","name":"clock-rotate-left"},"pages":[{"title":"Call and conversation history","href":"/platform/history"}]},{"group":"Tools","icon":{"style":"light","name":"toolbox"},"pages":[{"group":"Genius","pages":[{"title":"Get started with Genius knowledge bases","href":"/genius/getting-started"},{"title":"Data sources for Genius","href":"/genius/sources"},{"title":"Genius knowledge base best practices","href":"/genius/best-practices"},{"title":"Bind Genius knowledge to agents","href":"/genius/agent-binding"},{"title":"Troubleshoot Genius knowledge bases","href":"/genius/troubleshooting"}]},{"group":"Automations","pages":[{"title":"Get started with Thoughtly automations","href":"/automations/getting-started"},{"title":"Automation triggers","href":"/automations/triggers"},{"title":"Automation actions and steps","href":"/automations/actions"},{"title":"Attributes vs metadata in automations","href":"/automations/attributes-vs-metadata"},{"title":"Troubleshoot Thoughtly automations","href":"/automations/troubleshooting"}]},{"group":"Integrations","pages":[{"title":"Get started with Thoughtly integrations","href":"/integrations/getting-started"},{"title":"Webhooks configuration","href":"/integrations/webhooks"},{"title":"Troubleshoot Thoughtly integrations","href":"/integrations/troubleshooting"},{"title":"WhatsApp Business","href":"/integrations/communication/whatsapp-business"},{"title":"iMessage / Linq","href":"/integrations/communication/imessage-linq"},{"title":"CRM sync","href":"/integrations/crm/crm-sync"},{"title":"Code","href":"/integrations/developer/code"},{"title":"MCP Server","href":"/integrations/developer/mcp"}]}]},{"group":"Platform","icon":{"style":"light","name":"sliders"},"pages":[{"title":"Platform overview","href":"/platform/overview"},{"title":"Omnichannel agents","href":"/platform/omnichannel"},{"title":"Workspace switcher","href":"/platform/workspace-switcher"},{"title":"User menu","href":"/platform/user-menu"},{"group":"Workspaces","pages":[{"title":"Workspaces and team collaboration","href":"/platform/teams/overview"}]},{"title":"Billing on Thoughtly","href":"/platform/billing"},{"title":"Analytics in Thoughtly","href":"/platform/analytics"},{"group":"Settings","pages":[{"title":"General workspace settings","href":"/platform/settings/general"},{"title":"Audiences settings","href":"/platform/settings/audiences"},{"title":"Dark windows and quiet hours","href":"/platform/settings/dark-windows"},{"title":"Phone numbers settings","href":"/platform/settings/phone-numbers"},{"title":"Voices settings","href":"/platform/settings/voices"},{"title":"Usage and credit consumption","href":"/platform/settings/usage"},{"title":"Subscription and plan","href":"/platform/settings/subscription"},{"title":"Developer settings","href":"/platform/settings/developer"},{"title":"Email domains","href":"/platform/settings/email-domains"},{"title":"Audit log","href":"/platform/settings/audit-log"}]}]},{"group":"Phone Numbers","icon":{"style":"light","name":"phone"},"pages":[{"title":"Get started with phone numbers","href":"/phone-number/getting-started"},{"title":"Bring Your Own Carrier (BYOC)","href":"/phone-number/byoc"},{"title":"Phone number configuration and assignment","href":"/phone-number/configuration"},{"title":"Branded calling for outbound numbers","description":"Display your verified business name on supported outbound calls from Thoughtly to improve answer rates and reduce spam labeling on US carriers.","href":"/phone-number/branded-calling"},{"title":"Phone number billing and credits","href":"/phone-number/billing-credits"},{"title":"Troubleshoot phone numbers","description":"Diagnose and resolve common Thoughtly phone number issues including porting delays, inbound routing failures, spam labeling, and regional verification problems.","href":"/phone-number/troubleshooting"}]},{"group":"Genius","icon":{"style":"light","name":"brain"},"pages":[{"title":"Get started with Genius knowledge bases","href":"/genius/getting-started"},{"title":"Data sources for Genius","href":"/genius/sources"},{"title":"Genius knowledge base best practices","href":"/genius/best-practices"},{"title":"Bind Genius knowledge to agents","href":"/genius/agent-binding"},{"title":"Troubleshoot Genius knowledge bases","href":"/genius/troubleshooting"}]},{"group":"Automations","icon":{"style":"light","name":"code-branch"},"pages":[{"title":"Get started with Thoughtly automations","href":"/automations/getting-started"},{"title":"Automation triggers","href":"/automations/triggers"},{"title":"Automation actions and steps","href":"/automations/actions"},{"title":"Attributes vs metadata in automations","href":"/automations/attributes-vs-metadata"},{"title":"Troubleshoot Thoughtly automations","href":"/automations/troubleshooting"}]},{"group":"Resources","icon":{"style":"light","name":"graduation-cap"},"pages":[{"title":"Thoughtly FAQ","href":"/resources/faq"},{"title":"Video library","href":"/resources/video-library"},{"group":"Glossary","pages":[{"title":"Glossary","href":"/resources/glossary/overview"},{"title":"Voice agent","href":"/resources/glossary/voice-agent"},{"title":"Large language model (LLM)","href":"/resources/glossary/large-language-model"},{"title":"TTS (text-to-speech)","href":"/resources/glossary/tts"},{"title":"STT (speech-to-text)","href":"/resources/glossary/stt"},{"title":"Decision tree","href":"/resources/glossary/decision-tree"},{"title":"Happy path","href":"/resources/glossary/happy-path"},{"title":"RAG (retrieval-augmented generation)","href":"/resources/glossary/rag"},{"title":"Screen pop","href":"/resources/glossary/screen-pop"},{"title":"Carrier","href":"/resources/glossary/carrier"},{"title":"CRM","href":"/resources/glossary/crm"},{"title":"Workflow","href":"/resources/glossary/workflow"},{"title":"Variable","href":"/resources/glossary/variable"},{"title":"Transcript","href":"/resources/glossary/transcript"},{"title":"PII (personally identifiable information)","href":"/resources/glossary/pii"},{"title":"Dead end","href":"/resources/glossary/dead-end"},{"title":"OAuth","href":"/resources/glossary/oauth"},{"title":"Twilio","href":"/resources/glossary/twilio"},{"title":"Telnyx","href":"/resources/glossary/telnyx"},{"title":"Hallucination","href":"/resources/glossary/hallucination"},{"title":"AI voice","href":"/resources/glossary/ai-voice"}]},{"title":"Voice agent scheduling guide","href":"/resources/agent-scheduling"},{"title":"Call tagged contacts with an automation","href":"/resources/outbound-automation-tagged-contacts"},{"group":"Whitepapers","pages":[{"title":"Thoughtly whitepapers","href":"/resources/whitepapers/overview"},{"title":"Breaking free from intent-based dialog design","href":"/resources/whitepapers/conversational-ai"},{"title":"So you want to start an AI agency?","href":"/resources/whitepapers/agency-guide"}]}]},{"group":"Support","icon":{"style":"light","name":"life-ring"},"pages":[{"title":"Get support from Thoughtly","href":"/support/getting-help"},{"title":"Changelog","mode":"wide","href":"/support/changelog"},{"title":"Thoughtly referral program","sidebarTitle":"Referral Program","href":"/support/referral-program"}]}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/api-reference/agent/get-agents"}]},{"tab":"Promptbooks","pages":[{"title":"Promptbooks","href":"/promptbooks/browse"}]},{"tab":"Integrations","pages":[{"title":"Integrations","href":"/integrations/getting-started"}]}]},"title":"Phone number billing and credits - Thoughtly Docs","buildId":"dpl_cadrRc5H9XQiJQbDFN5mcYRs2PAj","deploymentId":"dpl_cadrRc5H9XQiJQbDFN5mcYRs2PAj","dynamics":[],"chunks":[]}