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.

Loading Code Sample...

Next Sample

Show Output

Output

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.