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

SDK Version:

Format:

TwiML

const VoiceResponse = require('twilio').twiml.VoiceResponse;

const response = new VoiceResponse();
response.hangup();

console.log(response.toString());

using Twilio.TwiML;
using System;


class Example
{
    static void Main()
    {
        var response = new VoiceResponse();
        response.Hangup();

        Console.WriteLine(response.ToString());;
    }
}

<?php
require_once './vendor/autoload.php';
use Twilio\Twiml;

$response = new Twiml();
$response->hangup();

echo $response;

require 'twilio-ruby'

response = Twilio::TwiML::VoiceResponse.new
response.hangup

puts response

from twilio.twiml.voice_response import Hangup, VoiceResponse

response = VoiceResponse()
response.hangup()

print(response)

import com.twilio.twiml.voice.Hangup;
import com.twilio.twiml.VoiceResponse;
import com.twilio.twiml.TwiMLException;


public class Example {
    public static void main(String[] args) {
        Hangup hangup = new Hangup.Builder().build();
        VoiceResponse response = new VoiceResponse.Builder().hangup(hangup)
            .build();

        try {
            System.out.println(response.toXml());
        } catch (TwiMLException e) {
            e.printStackTrace();
        }
    }
}

<?xml version="1.0" encoding="UTF-8"?>
<Response>
    <Hangup/>
</Response>

Hangup a Call

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.

Need some help?

We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd browsing the Twilio tag on Stack Overflow.

using Twilio.TwiML; using System; class Example { static void Main() { var response = new VoiceResponse(); response.Hangup(); Console.WriteLine(response.ToString());; } }

import com.twilio.twiml.voice.Hangup; import com.twilio.twiml.VoiceResponse; import com.twilio.twiml.TwiMLException; public class Example { public static void main(String[] args) { Hangup hangup = new Hangup.Builder().build(); VoiceResponse response = new VoiceResponse.Builder().hangup(hangup) .build(); try { System.out.println(response.toXml()); } catch (TwiMLException e) { e.printStackTrace(); } } }