SUPPORT.TWILIO.COM END OF LIFE NOTICE: This site,, is scheduled to go End of Life on February 27, 2024. All Twilio Support content has been migrated to, where you can continue to find helpful Support articles, API docs, and Twilio blog content, and escalate your issues to our Support team. We encourage you to update your bookmarks and begin using the new site today for all your Twilio Support needs.

How does Twilio's Free Trial work?

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.

Sign-up for a free Trial project

All new sign-ups get a small free trial balance for testing. To get your free trial, visit

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.

  1. Access the Buy a Number page in Console.
  2. Enter the criteria for the phone number you need, and then click Search.
    Screenshot 2023-07-17 at 1.34.19 PM.png
    • 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.
  3. 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.
    Screenshot 2023-07-17 at 1.36.10 PM.png

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:

Outbound calls and messages can also be placed from this number. You can find instructions for outbound communications in our API documentation:

Notice: Starting November 8, 2023, messages sent from Restricted (previously “Unverified”) Toll-Free phone numbers will be blocked in the US. To send messages to the verified phone numbers in the US you need to start the  Toll Free message verification process. Once you upgrade your project, you can start A2P 10DLC registration to use US local phone numbers to send text messages.

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:

Trial Limitations

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.

Have more questions? Submit a request
Powered by Zendesk