VAPI•2w ago

Missing Failure Webhook When Outbound Call Cannot Start

When I start a call with a request like this:

curl --location 'https://api.vapi.ai/call' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer redacted' \
--data '{
"assistantId": "dc5aca0b-8974-427d-86f2-9a007663bff0",
"assistantOverrides": {
"variableValues": {
"firstName": "Steve",
"lastName": "Thomas",
"fullName": "Steve Thomas",
"phoneNumber": "+923464801343",
"timeZoneFriendlyName": "Pakistan Time",
"timeZone": "Asia/Karachi",
"FirstName": "Steve",
"LastName": "Thomas"
}
},
"phoneNumberId": "e8b45f51-2967-4bd1-9c0e-64f802fc2451",
"customer": { "number": "+923464801343", "name": "Steve Thomas" }
}'

I received a 200 status code and a call ID:

019b0a53-24ab-744b-96ba-9b2750c7e8c0

However, this phone number is blocked on my Twilio account, so VAPI is failing to start the call. I am not receiving any status update or notification to let me know that the call failed.

Is there any way to receive a webhook or some kind of callback to notify me when a call fails to start?

Thanks.

broad-salmonOP•12/10/25, 10:18 PM

@Shubham Bajaj

Vapi Support BotAPP•12/10/25, 10:19 PM

To receive notifications when an outbound call fails to start (e.g., due to a blocked number), set up a webhook listener for the call-endedcall-ended event and check the

endedReason

endedReason

field for failure codes like twilio-failed-to-connect-calltwilio-failed-to-connect-call. Here’s a sample Express.js handler:

app.post('/webhook', (req, res) => {
  if (req.body.type === 'call-ended' && req.body.call.endedReason) {
    console.log('Call failed:', req.body.call.endedReason);
    // Handle failure notification here
  }
  res.sendStatus(200);
});

app.post('/webhook', (req, res) => {
  if (req.body.type === 'call-ended' && req.body.call.endedReason) {
    console.log('Call failed:', req.body.call.endedReason);
    // Handle failure notification here
  }
  res.sendStatus(200);
});

Update your Vapi webhook URL to point to this endpoint, and you’ll be notified of call failures via webhook events with the relevant reason code. For more details, see the Call ended reasons documentation.

Sources:

⤵️ Mention @Vapi Support Bot for follow-ups 🐥

broad-salmonOP•12/10/25, 10:34 PM

Ive already had the webhook setup, but I didnt receive this call-endedcall-ended event

broad-salmonOP•12/11/25, 9:45 PM

@1231325148079194222 could you support me pls?

broad-salmonOP•12/12/25, 2:56 PM

@1389712325300326490

KyleAPP•12/12/25, 9:58 PM

Make sure your twilio account status is not in trialtrial, then you should receive webhook status-updatestatus-update. We are currently seeing this error in the logs for your call id:

🔴 22:13:00:688 Couldn't initiate outbound call transport and queue for call 019b0a53-24ab-744b-96ba-9b2750c7e8c0. Error: Couldn't Create Twilio Call. Twilio Error: Account not authorized to call +923464801343. Perhaps you need to enable some international permissions: https://www.twilio.com/console/voice/calls/geo-permissions/low-risk

🔴 22:13:00:688 Couldn't initiate outbound call transport and queue for call 019b0a53-24ab-744b-96ba-9b2750c7e8c0. Error: Couldn't Create Twilio Call. Twilio Error: Account not authorized to call +923464801343. Perhaps you need to enable some international permissions: https://www.twilio.com/console/voice/calls/geo-permissions/low-risk

Ccomprehensive-tomato Make sure your twilio account status is not in `trial`, then you should receive ...

broad-salmonOP•12/15/25, 4:14 PM

Hey My Twilio is not in trial status
why did I not receive the webhook?

Missing Failure Webhook When Outbound Call Cannot Start

Similar Threads

Similar Threads

Similar Threads