> ## Documentation Index > Fetch the complete documentation index at: https://documentation.uponai.com/llms.txt > Use this file to discover all available pages before exploring further. # Purchase Phone Number > A step by step guide to buy a number from UponAI This guide will walk through how to purchase a number from UponAI. The numbers are managed by UponAI, so you don't have to worry about the telephony infrastructure. Currently we only support purchase of US and Canada numbers and support making calls to 15 countries. If you are looking to use numbers from other countries, or to make calls to more countries, or to use your own telephony provider, check out the [Custom Telephony guide](/Deploy/custom-telephony). ## From Dashboard Navigate to **VoIP Administration** in the top nav, then select **Phone Numbers**. VoIP Administration menu showing Phone Numbers, SMS Numbers, Carriers, Predefined Carriers, and UponAI VoIP Accounts

VoIP Administration menu showing Phone Numbers, SMS Numbers, Carriers, Predefined Carriers, and UponAI VoIP Accounts

You can purchase and bind agents to the number from the dashboard. You can optionally specify the area codes you want to purchase from. Add Phone Number dialog showing workspace, UponAI VoIP account, carrier, and phone number fields

Add Phone Number dialog showing workspace, UponAI VoIP account, carrier, and phone number fields

After the number is purchased, you can change its nickname so that it's easier to find and identify. At this stage, the number should already be ready to accept inbound calls if you have assigned an inbound agent. Give it a try by calling it! ## From API Check out the Create Phone Number API Reference for all the parameters you can use programmatically. Phone numbers are yours once purchased, and can be used indefinitely. You can assign different inbound and outbound agents to the number. If you don't want users to be able to call this number (e.g. you are doing outbound only and don't want callbacks), you can leave `inbound_agent_id` unset. ```javascript Node theme={null} const phoneNumberResponse = await uponai.phoneNumber.create({ inbound_agent_id: "oBeDLoLOeuAbiuaMFXRtDOLriTJ5tSxD", // replace with your agent id outbound_agent_id: "oBeDLoLOeuAbiuaMFXRtDOLriTJ5tSxD", // replace with your agent id }); console.log(phoneNumberResponse); ``` ```python Python theme={null} phone_number_response = uponai.phone_number.create( inbound_agent_id="oBeDLoLOeuAbiuaMFXRtDOLriTJ5tSxD", # replace with your agent id outbound_agent_id="oBeDLoLOeuAbiuaMFXRtDOLriTJ5tSxD", # replace with your agent id ) print(phone_number_response) ``` ## Pricing We support both Twilio and Telnyx numbers: * US numbers: \$2/month * US toll-free numbers: \$5/month * Canadian numbers: \$2/month * US numbers only: \$2/month Toll-free numbers cost \$0.06 per minute for inbound calls. Outbound calls are charged at the same rate as regular U.S. numbers.