On this page

TwiML™ Voice: <Hangup>

The <Hangup> verb ends a call. If used as the first verb in a TwiML response it does not prevent Twilio from answering the call and billing your account. The only way to not answer a call and prevent billing is to use the <Reject> verb.

Verb Attributes

The <Hangup> verb has no attributes.

Nesting Rules

You can't nest any verbs within <Hangup> and you can't nest <Hangup> within any other verbs.

Examples

Example 1

The following code tells Twilio to answer the call and hang up immediately.

Hangup a Call

1const VoiceResponse = require('twilio').twiml.VoiceResponse;
2
3
4const response = new VoiceResponse();
5response.hangup();
6
7console.log(response.toString());

Output

1<?xml version="1.0" encoding="UTF-8"?>
2<Response>
3    <Hangup/>
4</Response>

Hints and Advanced Uses

When receiving a Twilio request to an 'action' URL within <Gather>, <Record>, <Dial> or <Sms>, you can return a response containing the <Hangup> verb to end the current call.