Twilio offers a trial to all customers who sign up, which includes a free balance for you to experiment with. This guide is a quick primer on setting up your trial project so you can build something amazing with Twilio.
Getting a Phone Number
All trial projects can provision a free trial phone number for testing. Here's how to get started.
Notice: Trial project phone number selection may be limited. You must upgrade your Twilio project to provision more than one phone number, or to provision a number that is not available to trial projects.
- Access the Buy a Number page in Console.
- Enter the criteria for the phone number you need, and then click Search.
- Country: Select the desired country from the drop-down menu.
- Number or Location: Select the desired option to search by digits/phrases, or a specific City or Region.
- Capabilities: Select your service needs for this number.
- Advanced: Click this link to show options for the desired phone number type (local, mobile, toll-free), local address requirements, and to allow beta number results.
- Search results will be displayed with the phone number, location, type, capabilities, and price listed. Click Buy to purchase a phone number for your current project or sub-account.
Notice Many countries require identity documentation for Phone Number compliance. Requests to provision phone numbers with these regulations will be required to select or add the required documentation after clicking Buy in Console. To see which countries and phone number types are affected by these requirements, please see our Phone Number Regulations site.
Setup your Test
Your new Twilio phone number can now receive incoming calls and SMS messages. By default, incoming callers will hear a message saying that you have reached a Twilio line, while incoming messages will receive an SMS response. This can be modified by routing your phone number to a Twilio application you build. You can find steps on updating your phone number in these articles:
- Configuring Phone Numbers to Receive Calls
- Configuring Phone Numbers to Receive and Respond to SMS and MMS Messages
Outbound calls and messages can also be placed from this number. You can find instructions for outbound communications in our API documentation:
Notice: Trial projects require that you validate any non-Twilio phone numbers you make outbound tests to (see the Development Tips and Trial Limitations section below for more details).
There's really no limit to what sort of communications application you can create with Twilio. For those looking to build something more elaborate, we have a number of guides and tutorials that can help walk you through more complex concepts:
- Twilio Quickstart guides for using our products: https://www.twilio.com/docs/quickstart
- Twilio Tutorials for specific use-cases: https://www.twilio.com/docs/tutorials
Twilio Free Trial projects have some restrictions to how they can be used. For a list of the limitations you may run into, see Twilio Free Trial Limitations.
To remove these restrictions, Upgrade to a paid project account.