You can use your test credentials to test API requests to the outbound call endpoint without charging your account or making a call. Note that since no call is made, Twilio will not request the URL passed in the Url
parameter and no TwiML will be executed.
Send a POST
request to the outbound call API endpoint using your test credentials to authenticate and your TestAccountSid
in the URL as seen below:
POST https://api.twilio.com/2010-04-01/Accounts/{TestAccountSid}/Calls
Parameters
All the existing outbound call parameters will work. In addition, we provide some specific values for certain parameters to help you generate success and failure cases.
From
Your test credentials don't have access to any valid 'From' phone numbers on your real account. Therefore the only phone number you should use as a 'From' number is the magic numbers listed in the table below:
To
Value | Description | Error Code |
---|---|---|
+15005550001 | This phone number is invalid. | 21217 |
+15005550002 | Twilio cannot route to this number. | 21214 |
+15005550003 | Your account doesn't have the international permissions necessary to call this number. | 21215 |
+15005550004 | This number is blocked for your account. | 21216 |
All Others | Any other phone number is validated normally. | Input-dependent |
Use the API playground in this page to test each parameter values.
Encoding-type
The body parameters must be encoded using the application/x-www-form-urlencoded
encoding type. This means that the request headers must use this encoding-type for the content-type
field. Here is an example below:
content-type: application/x-www-form-urlencoded