Twilio offers a trial to all customers who sign up, which includes a free balance for you to experiment with. When your balance is getting low, Twilio will send you an email with information to upgrade your project.
Getting your Twilio trial going is an easy process. Below is a quick primer on setting up your trial number and some important development tips to make sure you build something amazing with Twilio.
Getting a Phone Number
- When you sign up for a your free Twilio Trial, you’ll be asked to verify your personal phone number. This is an important security step that is mandatory to trying Twilio.
- If you plan to use Twilio for voice and messaging, please head here to get your first Twilio phone number after verification.
- A shiny new Twilio number will be generated with its capabilities (Voice, SMS, or MMS) below it.
- If the number doesn’t have the capabilities you are looking for (some numbers do not have all three capabilities), you can click Search for a different number to find a number that better suits your needs by the country or capabilities.
- Once you have chosen your number, you’re ready to get testing!
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
These tips are very important to get the most out of your Twilio trial!
- We only allow one Twilio number per trial account. To get a different phone number than the one Twilio assigned you automatically, you need to release the current number you have on the Numbers page first.
- Phone numbers in Beta are made available to trial accounts. Check out this article on international numbers and their capabilities to find out which numbers are currently in Beta.
- If you upgrade your account, your trial number will be carried over and charged monthly according to current Voice or SMS rates.
- If your phone number is unused in your trial account for more than 30 days, it may be removed, as we unfortunately do not have an unlimited supply of phone numbers. That said, after returning to your Trial account you can purchase a new phone number at any time and start using your new number right away. Otherwise, if you are particularly attached to a phone number, you can upgrade your account by simply adding your credit card.
- Outbound messages and <Message> TwiML replies can only be sent to a validated phone number. Before attempting to send or reply to messages, be sure to verify the number. Some high cost and premium access numbers aren't reachable by default; for help enabling messages to a desired country, please see our Global SMS on Trial Accounts article.
- You will be able to send SMS from your SMS-enabled Twilio phone number, but not from your verified personal number. This rule also applies after the trial.
- When you send an SMS from your free trial phone number, it will begin with “Sent from a Twilio Trial account”. This message will be removed once your account has been upgraded.
- Alphanumeric Sender IDs cannot be used with trial accounts.
- Outbound trial calls can only be placed to a validated phone number. Before attempting to place an outbound call, be sure to verify the number.
- Some high cost and premium access numbers aren't reachable by default; for help enabling calling to countries outside of the US and Canada, please see our Geographic Permissions article.
- Calls to and from your free trial phone number will play a short trial message before your TwiML is executed.
- Trial accounts can only use your account's Twilio number, or a verified caller-ID, as the caller-ID (From number) when making outgoing calls.
- Outbound trial calls are limited to 10 minutes.
- Incoming calls on a trial account can't be recorded unless they're forwarded elsewhere with a <Dial> TwiML command with the
- A maximum of 5 total inbound and/or outbound concurrent calls are possible. When 5 calls are active, any further requests will be rejected with Error 10004: Call concurrency limit exceeded for account.
Elastic SIP Trunking
- You can fully configure an Elastic SIP Trunk for testing and placing actual calls to and from your business.
- Outbound trial calls can only be placed to a validated phone number. Before attempting to place an outbound call, be sure to verify the number. Phone numbers from 218 countries can be verified and reached on a trial account; for help enabling calls to a desired country, please see our Geographic Permissions article.
- Trial accounts are limited to a maximum of 1 Elastic SIP Trunk.
- Trial accounts are limited to a maximum of 1 Phone Number.
- Trial SIP trunks can only be used to place calls using your account’s Twilio number, or a Verified Caller-ID, as the Caller-ID/From number for Termination calls.
- Calls to and from your free trial phone number will play a short trial message before connecting the parties.
- A maximum of 4 total inbound and/or outbound concurrent calls are possible. When 4 calls are active, any further requests will be rejected.
Video: There are currently no specific restrictions for video.
Authy and Verify
- Maximum of 25 Calls made per day via the Authy or Verify API endpoints.
- Maximum of 35 SMS sent per day via the Authy or Verify API endpoints
- Maximum of 100 Calls and SMS per month via the Authy or Verify API endpoints
- Maximum of 50 Authy API registrations per minute.
Sandbox: If you are using Twilio’s Sandbox, read our FAQ on the restrictions of the old Sandbox.
Upgrade Your Account
To start using your Twilio phone number without these restrictions, just upgrade your project.