https://vapi.ai/ logo
Join Discord
Powered by
Twilio Number Setup - An error occurred in this ca...
# support
i
For two days now, I am trying to integrate Twilio phone number in order to run outbound calls with my Agent. I alredy did test calls with Vapi Free numbers and got really good results and now I want to scale. PLEASE, I need guidance.
v
The error 
call.start.error-get-transport
means Vapi can't retrieve your Twilio transport configuration. Please double-check that your Twilio credentials and phone number are correctly set in your environment variables. For example:
Copy code
env
TWILIO_ACCOUNT_SID=your_account_sid
TWILIO_AUTH_TOKEN=your_auth_token
FROM_NUMBER=your_twilio_number
Update these values in your 
.env
file or deployment settings, then restart your server and try again. For more details, see the [Call ended reasons documentation](https://docs.vapi.ai/calls/call-ended-reason). Source: - [Call ended reasons documentation](https://docs.vapi.ai/calls/call-ended-reason)
i
I am not a developer, I'm trying to setup with Vapi dashboard, not coding.
@Vapi Support Bot I need help
v
To fix the 
call.start.error-get-transport
error in the Vapi dashboard: 1. In your Twilio account, create an Elastic SIP Trunk and add Vapi's SIP server IPs (44.229.228.186 and 44.238.177.138) to the whitelist. 2. In the Vapi dashboard, go to Phone Numbers, click "Add Number," and register your Twilio number by following the prompts. 3. Once your number is registered, you can make outbound calls from the dashboard—no coding needed. If you need more details, see the [Vapi Twilio integration guide](https://docs.vapi.ai/advanced/sip/twilio). Source: - [Vapi Twilio SIP Integration Guide](https://docs.vapi.ai/advanced/sip/twilio)
i
I follow this guide, but somehow always get the same error. Also, when I Add the Phone number, it always marks it as 'vonage' instead of Twilio. Is there any chance I can hop on a call with someone from suppert in order to guide me in this process, I am willing to pay fee.
@Vapi @Vapi Support Bot
v
To ensure your Twilio number is correctly recognized in Vapi, use the dashboard's import feature: 1. Go to Phone Numbers in the Vapi dashboard and click Import. 2. Enter your Twilio number, Account SID, and Auth Token, then click Import. This should label your number as Twilio and resolve the transport error—double-check your credentials for accuracy. For step-by-step visuals, see the [Twilio import guide](https://docs.vapi.ai/phone-numbers/import-twilio). Source: - [Import number from Twilio](https://docs.vapi.ai/phone-numbers/import-twilio)
i
@Vapi Support Bot @Vapi there is no 'Import' option, there's only 'Create Phone Number' - the docs are with the old interface
@Vapi @Vapi Support Bot now I get the message An error occurred in this call: call.in-progress.error-sip-outbound-call-failed-to-connect
v
Action Step: Double-check your Twilio Elastic SIP Trunk settings—make sure you have whitelisted both Vapi SIP server IPs (
44.229.228.186
and 
44.238.177.138
) in your trunk's termination settings. This is a common cause of the 
call.in-progress.error-sip-outbound-call-failed-to-connect
error. After updating, try your outbound call again from the Vapi dashboard. For reference, see the [Vapi Twilio SIP integration guide](https://docs.vapi.ai/advanced/sip/twilio). Source: - [Vapi Twilio SIP Integration Guide](https://docs.vapi.ai/advanced/sip/twilio)
i
@Vapi Support Bot @Vapi everything is set up well. What else could be the problem?
v
Thank you for confirming your setup. To help narrow down the issue, could you please confirm if your Twilio number is currently assigned to the Elastic SIP Trunk you created, and if so, does the trunk show both Vapi SIP server IPs (
44.229.228.186
and 
44.238.177.138
) as whitelisted in the trunk's termination settings? Source: - [Vapi Twilio SIP Integration Guide](https://docs.vapi.ai/advanced/sip/twilio)
i
@Vapi Support Bot yes, correct.
v
Since the dashboard "Import" option is missing, try registering your Twilio number using the API. Here’s a concrete example:
Copy code
bash
curl -X POST https://api.vapi.ai/phone-number \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_VAPI_API_KEY" \
  -d '{
    "provider": "byo-phone-number",
    "name": "Twilio SIP Number",
    "number": "YOUR_TWILIO_NUMBER",
    "numberE164CheckEnabled": false,
    "credentialId": "YOUR_CREDENTIAL_ID"
  }'
Replace the placeholders with your actual details. This should correctly register your Twilio number and may resolve the SIP connection issue. For more details, see the [Vapi Twilio SIP integration guide](https://docs.vapi.ai/advanced/sip/twilio). Source: - [Vapi Twilio SIP integration guide](https://docs.vapi.ai/advanced/sip/twilio)
i
@Vapi Support Bot I don't even know where this code goes - how do I register a Twilio number using the API? Where do I start? I've seen this guide, but where do I input this code you sent me?
v
Since you are not a developer and the dashboard does not have an "Import" option, the easiest way to use the API is with a tool like [Postman](https://www.postman.com/): 1. Download and open Postman (it's free). 2. Create a new "POST" request to 
https://api.vapi.ai/phone-number
, copy the code snippet provided, and fill in your details (API key, Twilio number, etc.) in the appropriate fields. 3. Click "Send" to register your Twilio number. If you need step-by-step help with Postman, let me know and I can walk you through each screen. For more details, see the [Vapi Twilio SIP integration guide](https://docs.vapi.ai/advanced/sip/twilio). Source: - [Vapi Twilio SIP integration guide](https://docs.vapi.ai/advanced/sip/twilio)
i
Is this format good for the request: https://api.vapi.ai/+12243872329 @Vapi Support Bot
v
No, the format 
https://api.vapi.ai/+12243872329
is not correct. You should use the endpoint 
https://api.vapi.ai/phone-number
and include your phone number in the JSON body of a POST request. Here’s a concrete example:
Copy code
json
POST https://api.vapi.ai/phone-number
{
  "provider": "byo-phone-number",
  "number": "+12243872329",
  "credentialId": "YOUR_CREDENTIAL_ID"
}
Replace the placeholders with your actual details. For more info, see the [API documentation](https://docs.vapi.ai/api-reference/phone-numbers/create). Source: - [Create Phone Number API Reference](https://docs.vapi.ai/api-reference/phone-numbers/create)
i
@Vapi @Vapi Support Bot can you send me detailed instruction step-by-step how to do this with Postman? I've downloaded it and installed it.
v
Step-by-step: Register your Twilio number with Vapi using Postman 1. In Postman, create a new POST request to 
https://api.vapi.ai/phone-number
. 2. Under the Headers tab, add: - 
Authorization: Bearer YOUR_VAPI_API_KEY
- 
Content-Type: application/json
3. In the Body tab (select "raw" and "JSON"), paste and edit:
Copy code
json
{
  "provider": "byo-phone-number",
  "name": "Twilio SIP Number",
  "number": "+YOUR_TWILIO_NUMBER",
  "numberE164CheckEnabled": false,
  "credentialId": "YOUR_CREDENTIAL_ID"
}
Click "Send" to register. Replace all placeholders with your actual details. For more info, see the [API documentation](https://docs.vapi.ai/api-reference/phone-numbers/create). Source: - [Create Phone Number API Reference](https://docs.vapi.ai/api-reference/phone-numbers/create)
i
how do I replace phone-number ? the number I need to use is +12243872329
@Vapi Support Bot
v
Do not replace "phone-number" in the URL. Use this exact URL in Postman:
Copy code
https://api.vapi.ai/phone-number
Then, in the Body (set to "raw" and "JSON"), use:
Copy code
json
{
  "provider": "byo-phone-number",
  "number": "+12243872329",
  "credentialId": "YOUR_CREDENTIAL_ID"
}
Just put your phone number in the JSON body as shown—do not change the URL! For more details, see the [API documentation](https://docs.vapi.ai/api-reference/phone-numbers/create). Source: - [Create Phone Number API Reference](https://docs.vapi.ai/api-reference/phone-numbers/create)
i
where do I find YOUR_CREDENTIAL_ID
@Vapi Support Bot
v
To find your 
YOUR_CREDENTIAL_ID
, you need to create a SIP trunk credential in Vapi. Here’s how: 1. Make a POST request to the credentials endpoint (you can use Postman) with your Twilio SIP details:
Copy code
json
POST https://api.vapi.ai/credential
{
  "provider": "byo-sip-trunk",
  "name": "Twilio Trunk",
  "gateways": [
    { "ip": "YOUR_TWILIO_GATEWAY_ID", "inboundEnabled": false }
  ],
  "outboundLeadingPlusEnabled": true
}
2. The response will include an 
"id"
field—**this is your `credentialId`** to use in the phone number registration step. For more details, see the [Vapi Twilio SIP integration guide](https://docs.vapi.ai/advanced/sip/twilio). Source: - [Vapi Twilio SIP integration guide](https://docs.vapi.ai/advanced/sip/twilio)
i
Is there an option that someone can guide me in this process? @Vapi Support Bot
v
Currently, Vapi does not mention a live or personal support option in the documentation. For step-by-step help, your best option is to follow the detailed Postman instructions already provided, or reach out via the official Vapi support channels (such as their documentation feedback or contact forms) for further assistance. If you have a specific step where you're stuck, let me know exactly which screen or error you're seeing, and I can walk you through that part in detail. For reference, see the [Vapi Twilio SIP integration guide](https://docs.vapi.ai/advanced/sip/twilio). Source: - [Vapi Twilio SIP integration guide](https://docs.vapi.ai/advanced/sip/twilio)
i
@Vapi Support Bot can you send me here detailed step-by-step guide, literally guiding me - I want to start all over again
v
Step 1: In Postman, create a new POST request to 
https://api.vapi.ai/credential
. Step 2: Under Headers, add: - 
Authorization: Bearer YOUR_VAPI_API_KEY
- 
Content-Type: application/json
Step 3: In the Body (set to "raw" and "JSON"), paste and edit:
Copy code
json
{
  "provider": "byo-sip-trunk",
  "name": "Twilio Trunk",
  "gateways": [
    { "ip": "YOUR_TWILIO_SIP_DOMAIN", "inboundEnabled": false }
  ],
  "outboundLeadingPlusEnabled": true
}
Click "Send" and copy the 
"id"
from the response—this is your 
credentialId
for the next step. For more, see the [Vapi Twilio SIP integration guide](https://docs.vapi.ai/advanced/sip/twilio). Source: - [Vapi Twilio SIP integration guide](https://docs.vapi.ai/advanced/sip/twilio)
i
I got this response: { "id": "a0892c19-225d-43c8-98af-9c574ebbfad0", "orgId": "456c63f4-844c-44fe-ab1c-3439765fdcd8", "provider": "byo-sip-trunk", "createdAt": "2025-11-28T13:04:50.290Z", "updatedAt": "2025-11-28T13:04:50.290Z", "gateways": [ { "ip": "impel-elastic.pstn.twilio.com", "inboundEnabled": false } ], "name": "Twilio Trunk", "outboundLeadingPlusEnabled": true } @Vapi Support Bot
v
Next Step: Register Your Twilio Number in Postman In Postman, create a POST request to 
https://api.vapi.ai/phone-number
. Set the **Headers**: - 
Authorization: Bearer YOUR_VAPI_API_KEY
- 
Content-Type: application/json
In the Body (set to "raw" and "JSON"), use:
Copy code
json
{
  "provider": "byo-phone-number",
  "number": "+12243872329",
  "credentialId": "a0892c19-225d-43c8-98af-9c574ebbfad0"
}
Click "Send" to register your number. For more details, see the [API documentation](https://docs.vapi.ai/api-reference/phone-numbers/create). Source: - [Create Phone Number API Reference](https://docs.vapi.ai/api-reference/phone-numbers/create)
i
Okay, I got success! Do I need to do anything else
This is the response I got: { "id": "8b718355-ffa7-42d0-bc27-66095ad87fe0", "orgId": "456c63f4-844c-44fe-ab1c-3439765fdcd8", "number": "+12243872329", "createdAt": "2025-11-28T13:08:48.738Z", "updatedAt": "2025-11-28T13:08:48.738Z", "credentialId": "a0892c19-225d-43c8-98af-9c574ebbfad0", "provider": "byo-phone-number", "status": "active", "providerResourceId": "a51c402f-1c82-4a45-a4fa-fc33a1ee25e7" }
Now, I have the phone number in Vapi, but when I'm trying to make a call I get the following error: An error occurred in this call: call.in-progress.error-providerfault-outbound-sip-403-forbidden
@Vapi Support Bot
v
Suggestion: A SIP 403 Forbidden error usually means Twilio is blocking the call due to authentication or IP restrictions. Please double-check that both Vapi SIP server IPs are whitelisted in your Twilio Elastic SIP Trunk's termination settings:
Copy code
44.229.228.186
44.238.177.138
After confirming, try your call again. For more details, see the [Vapi Twilio SIP integration guide](https://docs.vapi.ai/advanced/sip/twilio). Source: - [Vapi Twilio SIP integration guide](https://docs.vapi.ai/advanced/sip/twilio)
i
I've checked and it's confirmed. Maybe I need to add credentials? @Vapi Support Bot
v
If Twilio is still returning a 403 Forbidden error after IP whitelisting, try adding SIP authentication credentials to your Vapi SIP trunk credential. In Postman, update your credential creation body to include an 
outboundAuthenticationPlan
section like this:
Copy code
json
{
  "provider": "byo-sip-trunk",
  "name": "Twilio Trunk",
  "gateways": [
    { "ip": "impel-elastic.pstn.twilio.com", "inboundEnabled": false }
  ],
  "outboundLeadingPlusEnabled": true,
  "outboundAuthenticationPlan": {
    "authUsername": "YOUR_TWILIO_USERNAME",
    "authPassword": "YOUR_TWILIO_PASSWORD"
  }
}
Replace with your actual Twilio SIP credentials, then use the new 
credentialId
for your phone number. See the [Vapi Twilio SIP integration guide](https://docs.vapi.ai/advanced/sip/twilio) for more details. Source: - [Vapi Twilio SIP integration guide](https://docs.vapi.ai/advanced/sip/twilio)
i
Okay, I did this, now I have different credentialID, this is the response I got: { "id": "8b718355-ffa7-42d0-bc27-66095ad87fe0", "orgId": "456c63f4-844c-44fe-ab1c-3439765fdcd8", "number": "+12243872329", "createdAt": "2025-11-28T13:08:48.738Z", "updatedAt": "2025-11-28T13:08:48.738Z", "credentialId": "a0892c19-225d-43c8-98af-9c574ebbfad0", "provider": "byo-phone-number", "status": "active", "providerResourceId": "a51c402f-1c82-4a45-a4fa-fc33a1ee25e7" } Can you please guide me for the next step with the phone number? @Vapi Support Bot do I need to add credentials there also (user/pass)?
v
To confirm: After creating the new SIP trunk credential with your Twilio username and password, did you re-register your phone number in Vapi using the updated 
credentialId
? If not, please update the phone number with the new 
credentialId
and try making a call again. Let me know if you need step-by-step instructions for this update. Sources: - [Vapi Twilio SIP integration guide](https://docs.vapi.ai/advanced/sip/twilio) - [Create Phone Number API Reference](https://docs.vapi.ai/api-reference/phone-numbers/create)
i
No I haven't. I created this body: { "provider": "byo-phone-number", "number": "+12243872329", "credentialId": "8b718355-ffa7-42d0-bc27-66095ad87fe0" } just let me know if I should add user/password for this step also?
@Vapi Support Bot
v
You do NOT need to add user/password at the phone number step. Just update your existing phone number to reference the new 
credentialId
(the one with your Twilio SIP credentials) using a PATCH request like this:
Copy code
json
{
  "credentialId": "YOUR_NEW_CREDENTIAL_ID"
}
No additional authentication fields are needed at the phone number level—authentication is handled by the SIP trunk credential. See the [Update Phone Number API Reference](https://docs.vapi.ai/api-reference/phone-numbers/update?explorer=true) for details. Source: - [Update Phone Number API Reference](https://docs.vapi.ai/api-reference/phone-numbers/update?explorer=true)
i
But I was thinking I'm starting the procedure all over again and deleted my previously added Phone Number from Vapi Dashboard, so can you give me instructions how to add it again? (post/headers/body etc)?
@Vapi Support Bot
v
To re-add your Twilio phone number in Vapi, make a POST request to 
https://api.vapi.ai/phone-number
with these settings: Headers: - 
Authorization: Bearer YOUR_VAPI_API_KEY
- 
Content-Type: application/json
Body (raw, JSON):
Copy code
json
{
  "provider": "byo-phone-number",
  "number": "+12243872329",
  "credentialId": "YOUR_NEW_CREDENTIAL_ID"
}
Replace 
YOUR_VAPI_API_KEY
and 
YOUR_NEW_CREDENTIAL_ID
with your actual values. Click "Send" in Postman to complete the registration. For more details, see the [API documentation](https://docs.vapi.ai/api-reference/phone-numbers/create?explorer=true). Source: - [Create Phone Number API Reference](https://docs.vapi.ai/api-reference/phone-numbers/create?explorer=true)
i
v
Action: Double-check that you are using the credentialId from your most recent SIP trunk credential creation (not the phone number ID) in your POST request. Your request body should look like this:
Copy code
json
{
  "provider": "byo-phone-number",
  "number": "+12243872329",
  "credentialId": "YOUR_SIP_TRUNK_CREDENTIAL_ID"
}
Replace 
YOUR_SIP_TRUNK_CREDENTIAL_ID
with the actual credentialId returned from the SIP trunk creation response (it should look like 
a0892c19-225d-43c8-98af-9c574ebbfad0
). See the [Vapi Twilio SIP integration guide](https://docs.vapi.ai/advanced/sip/twilio) for reference. Source: - [Vapi Twilio SIP integration guide](https://docs.vapi.ai/advanced/sip/twilio)
i
Okay, I started all over again. I created the API POST for credential, this is the response I received (success): { "id": "e43c2284-0e98-4ba5-9608-3fd2f3cfbbd1", "orgId": "456c63f4-844c-44fe-ab1c-3439765fdcd8", "provider": "byo-sip-trunk", "createdAt": "2025-11-28T14:07:01.544Z", "updatedAt": "2025-11-28T14:07:01.544Z", "gateways": [ { "ip": "impel-elastic.pstn.twilio.com", "inboundEnabled": false } ], "name": "Twilio Trunk", "outboundAuthenticationPlan": { "authUsername": "ACa5080a64c3203fb2a0d68f4c3f386251" }, "outboundLeadingPlusEnabled": true } Now I will go to next step and POST for the phone-number, will use the body you provided with this ID: e43c2284-0e98-4ba5-9608-3fd2f3cfbbd1 - is it okay?
@Vapi Support Bot
v
Yes, you are on the right track! To add your Twilio phone number to Vapi, use the credentialId you just received (
e43c2284-0e98-4ba5-9608-3fd2f3cfbbd1
) in your POST request. Your request should look like this: POST to 
https://api.vapi.ai/phone-number
Headers: - 
Authorization: Bearer YOUR_VAPI_API_KEY
- 
Content-Type: application/json
Body (raw, JSON):
Copy code
json
{
  "provider": "byo-phone-number",
  "number": "+12243872329",
  "credentialId": "e43c2284-0e98-4ba5-9608-3fd2f3cfbbd1"
}
Just replace 
YOUR_VAPI_API_KEY
with your actual API key. No need to add user/password at this step—the authentication is already handled by the SIP trunk credential you created. Once you send this request, your phone number should be registered and ready for use!
i
Call ID is: 019acacd-b616-7555-8875-0534c6409d28
Okay, I got success! (201 Created) and I see the phone number in my Vapi dashboard. Now I tried to make a call, but got this error message: An error occurred in this call: call.in-progress.error-providerfault-outbound-sip-403-forbidden
@Vapi Support Bot
Do I need to add Origination in Twilio now?
v
Next step: Please log in to your Twilio console and double-check that both Vapi SIP server IPs are whitelisted in your Elastic SIP Trunk's Termination settings: - 
44.229.228.186
- 
44.238.177.138
If either IP is missing, add it and try your call again. For reference, see the [Vapi Twilio SIP integration guide](https://docs.vapi.ai/advanced/sip/twilio). Source: - [Vapi Twilio SIP integration guide](https://docs.vapi.ai/advanced/sip/twilio)
i
That's correct. Still getting the same error: An error occurred in this call: call.in-progress.error-providerfault-outbound-sip-403-forbidden
@Vapi Support Bot
v
Suggestion: Your SIP trunk credential is missing the 
authPassword
field, which is required for authentication with Twilio. Please recreate your SIP trunk credential with both 
authUsername
and 
authPassword
included, like this:
Copy code
json
{
  "provider": "byo-sip-trunk",
  "name": "Twilio Trunk",
  "gateways": [
    { "ip": "impel-elastic.pstn.twilio.com", "inboundEnabled": false }
  ],
  "outboundAuthenticationPlan": {
    "authUsername": "YOUR_TWILIO_USERNAME",
    "authPassword": "YOUR_TWILIO_PASSWORD"
  },
  "outboundLeadingPlusEnabled": true
}
After creating the new credential, re-register your phone number using the new 
credentialId
. See the [Vapi Twilio SIP integration guide](https://docs.vapi.ai/advanced/sip/twilio) for reference. Source: - [Vapi Twilio SIP integration guide](https://docs.vapi.ai/advanced/sip/twilio)
i
I already did that.
@Vapi Support Bot
v
Thank you for confirming that you've already recreated your SIP trunk credential with both authUsername and authPassword, and re-registered your phone number. Since you've also verified that the Vapi SIP server IPs are whitelisted in your Twilio Elastic SIP Trunk's Termination settings, and all previous steps have been followed, you've covered the main configuration requirements. A persistent 403 Forbidden error from Twilio typically indicates an authentication or permission issue. Double-check that the authUsername and authPassword you entered in the SIP trunk credential exactly match the credentials set up in your Twilio SIP Trunk's Termination credentials list. Even a small typo or mismatch can cause this error. If everything matches and the error still occurs, there may be a Twilio-side restriction or configuration detail that needs to be addressed, such as the allowed calling destinations, trunk permissions, or credential list assignment to the trunk. Unfortunately, I do not have access to further details beyond what you've already provided and the steps you've taken. If you have already verified all of the above and the issue persists, I do not have additional troubleshooting steps to suggest based on the information available.
l
Im getting the same call.start.error-get-transport,the calls use to work till Monday now its showing this error i tried changing the number and the assistant also the number in twilio is active but still it shows it
f
Having the same issue
l
I fixed the problem the twilio number was out of subscription
c
Glad you were able to get this resolved. If anything else comes up or you need further assistance, we’re here to help.
f
My twilio numer is active... I don't understand why Im having this error
k
please provide a call id for a failed call
f
Call ID 019aecbf-7932-766b-903c-075a3f6996ad
c
Thanks for the call id. This call was made with a Vapi free number and it failed because the destination was a non-US phone number. Here is the error from the logs:
Copy code
"status":"ended"
"endedReason":"call.start.error-vapi-number-international"
PreviousNext
Powered by