Skip to contentSkip to navigationSkip to topbar
Twilio Docs
Page tools
On this page

TwiML

Call Redirected

call-redirected page anchor

com.twilio.voice.twiml.call.redirected

(information)

Info

This event is only available when subscribed to in the original API request or TwiML response. In other words, your TwiML or API request must also provide a status callback URL and the events you wish to receive.

TwiML Call Redirected events are compatible with Webhook, Kinesis and Segment sinks. To learn more, you can get started with the Webhook, Kinesis or Segment quickstarts and refer to the product documentation.

Examples

1
{

2
  "specversion" : "1.0",

3
  "type" : "com.twilio.voice.twiml.call.redirected",

4
  "source" : "AB00000000000000000000000001",

5
  "id" : "NO00000000000000000000000001",

6
  "dataschema" : "https://events-schemas.twilio.com/Voice.WebhookEvent/2",

7
  "datacontenttype" : "2025-10-08T07:17:02.363Z",

8
  "data" : {

9
    "sid" : "CA0000000000000000000000000000001",

10
    "requestDateCreated" : "Sun, 24 Aug 2025 13:49:54 +0000",

11
    "timestamp" : "2025-01-01T00:00:00.000Z",

12
    "eventSid" : "VW0000000000000000000000000000001",

13
    "request" : {

14
      "method" : "POST",

15
      "url" : "https://mycompany.com/an-endpoint",

16
      "parameters" : { }

17
    },

18
    "response" : {

19
      "responseCode" : 200,

20
      "requestDuration" : 140,

21
      "contentType" : "application/xml;charset=UTF-8",

22
      "responseBody" : "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz48UmVzcG9uc2U+PFNheT48L1NheT48UGF1c2UgbGVuZ3RoPSIxIi8+PFJlZGlyZWN0IG1ldGhvZD0iUE9TVCI+aHR0cHM6Ly9teWNvbXBhbnkuY29tL2FuLWVuZHBvaW50PC9SZWRpcmVjdD48L1Jlc3BvbnNlPg==",

23
      "dateCreated" : "Sun, 24 Aug 2025 13:49:54 +0000"

24
    }

25
  }

26
}

Versions

Call Transferred

call-transferred page anchor

com.twilio.voice.twiml.call.transferred

(information)

Info

This event is only available when subscribed to in the original API request or TwiML response. In other words, your TwiML or API request must also provide a status callback URL and the events you wish to receive.

TwiML Call Transferred events are compatible with Webhook, Kinesis and Segment sinks. To learn more, you can get started with the Webhook, Kinesis or Segment quickstarts and refer to the product documentation.

Examples

1
{

2
  "specversion" : "1.0",

3
  "type" : "com.twilio.voice.twiml.call.transferred",

4
  "source" : "AB00000000000000000000000001",

5
  "id" : "NO00000000000000000000000001",

6
  "dataschema" : "https://events-schemas.twilio.com/Voice.WebhookEvent/2",

7
  "datacontenttype" : "2025-10-08T07:17:02.363Z",

8
  "data" : {

9
    "sid" : "CA0000000000000000000000000000001",

10
    "requestDateCreated" : "Sun, 24 Aug 2025 13:49:54 +0000",

11
    "timestamp" : "2025-01-01T00:00:00.000Z",

12
    "eventSid" : "VW0000000000000000000000000000001",

13
    "request" : {

14
      "method" : "POST",

15
      "url" : "https://mycompany.com/an-endpoint",

16
      "parameters" : { }

17
    },

18
    "response" : {

19
      "responseCode" : 200,

20
      "requestDuration" : 140,

21
      "contentType" : "application/xml;charset=UTF-8",

22
      "responseBody" : "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz48UmVzcG9uc2U+PFNheT48L1NheT48UGF1c2UgbGVuZ3RoPSIxIi8+PFJlZGlyZWN0IG1ldGhvZD0iUE9TVCI+aHR0cHM6Ly9teWNvbXBhbnkuY29tL2FuLWVuZHBvaW50PC9SZWRpcmVjdD48L1Jlc3BvbnNlPg==",

23
      "dateCreated" : "Sun, 24 Aug 2025 13:49:54 +0000"

24
    }

25
  }

26
}

Versions

Dial Finished

dial-finished page anchor

com.twilio.voice.twiml.dial.finished

(information)

Info

This event is only available when subscribed to in the original API request or TwiML response. In other words, your TwiML or API request must also provide a status callback URL and the events you wish to receive.

TwiML Dial Finished events are compatible with Webhook, Kinesis and Segment sinks. To learn more, you can get started with the Webhook, Kinesis or Segment quickstarts and refer to the product documentation.

Examples

1
{

2
  "specversion" : "1.0",

3
  "type" : "com.twilio.voice.twiml.dial.finished",

4
  "source" : "AB00000000000000000000000001",

5
  "id" : "NO00000000000000000000000001",

6
  "dataschema" : "https://events-schemas.twilio.com/Voice.WebhookEvent/2",

7
  "datacontenttype" : "2025-10-08T07:17:02.363Z",

8
  "data" : {

9
    "sid" : "CA0000000000000000000000000000001",

10
    "requestDateCreated" : "Sun, 24 Aug 2025 13:49:54 +0000",

11
    "timestamp" : "2025-01-01T00:00:00.000Z",

12
    "eventSid" : "VW0000000000000000000000000000001",

13
    "request" : {

14
      "method" : "POST",

15
      "url" : "https://mycompany.com/an-endpoint",

16
      "parameters" : { }

17
    },

18
    "response" : {

19
      "responseCode" : 200,

20
      "requestDuration" : 140,

21
      "contentType" : "application/xml;charset=UTF-8",

22
      "responseBody" : "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz48UmVzcG9uc2U+PFNheT48L1NheT48UGF1c2UgbGVuZ3RoPSIxIi8+PFJlZGlyZWN0IG1ldGhvZD0iUE9TVCI+aHR0cHM6Ly9teWNvbXBhbnkuY29tL2FuLWVuZHBvaW50PC9SZWRpcmVjdD48L1Jlc3BvbnNlPg==",

23
      "dateCreated" : "Sun, 24 Aug 2025 13:49:54 +0000"

24
    }

25
  }

26
}

Versions

Enqueue Finished

enqueue-finished page anchor

com.twilio.voice.twiml.enqueue.finished

(information)

Info

This event is only available when subscribed to in the original API request or TwiML response. In other words, your TwiML or API request must also provide a status callback URL and the events you wish to receive.

TwiML Enqueue Finished events are compatible with Webhook, Kinesis and Segment sinks. To learn more, you can get started with the Webhook, Kinesis or Segment quickstarts and refer to the product documentation.

Examples

1
{

2
  "specversion" : "1.0",

3
  "type" : "com.twilio.voice.twiml.enqueue.finished",

4
  "source" : "AB00000000000000000000000001",

5
  "id" : "NO00000000000000000000000001",

6
  "dataschema" : "https://events-schemas.twilio.com/Voice.WebhookEvent/2",

7
  "datacontenttype" : "2025-10-08T07:17:02.363Z",

8
  "data" : {

9
    "sid" : "CA0000000000000000000000000000001",

10
    "requestDateCreated" : "Sun, 24 Aug 2025 13:49:54 +0000",

11
    "timestamp" : "2025-01-01T00:00:00.000Z",

12
    "eventSid" : "VW0000000000000000000000000000001",

13
    "request" : {

14
      "method" : "POST",

15
      "url" : "https://mycompany.com/an-endpoint",

16
      "parameters" : { }

17
    },

18
    "response" : {

19
      "responseCode" : 200,

20
      "requestDuration" : 140,

21
      "contentType" : "application/xml;charset=UTF-8",

22
      "responseBody" : "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz48UmVzcG9uc2U+PFNheT48L1NheT48UGF1c2UgbGVuZ3RoPSIxIi8+PFJlZGlyZWN0IG1ldGhvZD0iUE9TVCI+aHR0cHM6Ly9teWNvbXBhbnkuY29tL2FuLWVuZHBvaW50PC9SZWRpcmVjdD48L1Jlc3BvbnNlPg==",

23
      "dateCreated" : "Sun, 24 Aug 2025 13:49:54 +0000"

24
    }

25
  }

26
}

Versions

Gather Finished

gather-finished page anchor

com.twilio.voice.twiml.gather.finished

(information)

Info

This event is only available when subscribed to in the original API request or TwiML response. In other words, your TwiML or API request must also provide a status callback URL and the events you wish to receive.

TwiML Gather Finished events are compatible with Webhook, Kinesis and Segment sinks. To learn more, you can get started with the Webhook, Kinesis or Segment quickstarts and refer to the product documentation.

Examples

1
{

2
  "specversion" : "1.0",

3
  "type" : "com.twilio.voice.twiml.gather.finished",

4
  "source" : "AB00000000000000000000000001",

5
  "id" : "NO00000000000000000000000001",

6
  "dataschema" : "https://events-schemas.twilio.com/Voice.WebhookEvent/2",

7
  "datacontenttype" : "2025-10-08T07:17:02.363Z",

8
  "data" : {

9
    "sid" : "CA0000000000000000000000000000001",

10
    "requestDateCreated" : "Sun, 24 Aug 2025 13:49:54 +0000",

11
    "timestamp" : "2025-01-01T00:00:00.000Z",

12
    "eventSid" : "VW0000000000000000000000000000001",

13
    "request" : {

14
      "method" : "POST",

15
      "url" : "https://mycompany.com/an-endpoint",

16
      "parameters" : { }

17
    },

18
    "response" : {

19
      "responseCode" : 200,

20
      "requestDuration" : 140,

21
      "contentType" : "application/xml;charset=UTF-8",

22
      "responseBody" : "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz48UmVzcG9uc2U+PFNheT48L1NheT48UGF1c2UgbGVuZ3RoPSIxIi8+PFJlZGlyZWN0IG1ldGhvZD0iUE9TVCI+aHR0cHM6Ly9teWNvbXBhbnkuY29tL2FuLWVuZHBvaW50PC9SZWRpcmVjdD48L1Jlc3BvbnNlPg==",

23
      "dateCreated" : "Sun, 24 Aug 2025 13:49:54 +0000"

24
    }

25
  }

26
}

Versions

Record Finished

record-finished page anchor

com.twilio.voice.twiml.record.finished

(information)

Info

This event is only available when subscribed to in the original API request or TwiML response. In other words, your TwiML or API request must also provide a status callback URL and the events you wish to receive.

TwiML Record Finished events are compatible with Webhook, Kinesis and Segment sinks. To learn more, you can get started with the Webhook, Kinesis or Segment quickstarts and refer to the product documentation.

Examples

1
{

2
  "specversion" : "1.0",

3
  "type" : "com.twilio.voice.twiml.record.finished",

4
  "source" : "AB00000000000000000000000001",

5
  "id" : "NO00000000000000000000000001",

6
  "dataschema" : "https://events-schemas.twilio.com/Voice.WebhookEvent/2",

7
  "datacontenttype" : "2025-10-08T07:17:02.363Z",

8
  "data" : {

9
    "sid" : "CA0000000000000000000000000000001",

10
    "requestDateCreated" : "Sun, 24 Aug 2025 13:49:54 +0000",

11
    "timestamp" : "2025-01-01T00:00:00.000Z",

12
    "eventSid" : "VW0000000000000000000000000000001",

13
    "request" : {

14
      "method" : "POST",

15
      "url" : "https://mycompany.com/an-endpoint",

16
      "parameters" : { }

17
    },

18
    "response" : {

19
      "responseCode" : 200,

20
      "requestDuration" : 140,

21
      "contentType" : "application/xml;charset=UTF-8",

22
      "responseBody" : "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz48UmVzcG9uc2U+PFNheT48L1NheT48UGF1c2UgbGVuZ3RoPSIxIi8+PFJlZGlyZWN0IG1ldGhvZD0iUE9TVCI+aHR0cHM6Ly9teWNvbXBhbnkuY29tL2FuLWVuZHBvaW50PC9SZWRpcmVjdD48L1Jlc3BvbnNlPg==",

23
      "dateCreated" : "Sun, 24 Aug 2025 13:49:54 +0000"

24
    }

25
  }

26
}

Versions

Request Failed

request-failed page anchor

com.twilio.voice.twiml.request.failed

(information)

Info

This event is only available when subscribed to in the original API request or TwiML response. In other words, your TwiML or API request must also provide a status callback URL and the events you wish to receive.

TwiML Request Failed events are compatible with Webhook and Kinesis sinks. To learn more, you can get started with the Webhook or Kinesis quickstarts and refer to the product documentation.

Examples

1
{

2
  "specversion" : "1.0",

3
  "type" : "com.twilio.voice.twiml.request.failed",

4
  "source" : "AB00000000000000000000000001",

5
  "id" : "NO00000000000000000000000001",

6
  "dataschema" : "https://events-schemas.twilio.com/Voice.WebhookEvent/2",

7
  "datacontenttype" : "2025-10-08T07:17:02.363Z",

8
  "data" : {

9
    "sid" : "CA0000000000000000000000000000001",

10
    "requestDateCreated" : "Sun, 24 Aug 2025 13:49:54 +0000",

11
    "timestamp" : "2025-01-01T00:00:00.000Z",

12
    "eventSid" : "VW0000000000000000000000000000001",

13
    "request" : {

14
      "method" : "POST",

15
      "url" : "https://mycompany.com/an-endpoint",

16
      "parameters" : { }

17
    },

18
    "response" : {

19
      "responseCode" : 200,

20
      "requestDuration" : 140,

21
      "contentType" : "application/xml;charset=UTF-8",

22
      "responseBody" : "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz48UmVzcG9uc2U+PFNheT48L1NheT48UGF1c2UgbGVuZ3RoPSIxIi8+PFJlZGlyZWN0IG1ldGhvZD0iUE9TVCI+aHR0cHM6Ly9teWNvbXBhbnkuY29tL2FuLWVuZHBvaW50PC9SZWRpcmVjdD48L1Jlc3BvbnNlPg==",

23
      "dateCreated" : "Sun, 24 Aug 2025 13:49:54 +0000"

24
    }

25
  }

26
}

Versions

Requested

requested page anchor

com.twilio.voice.twiml.call.requested

(information)

Info

This event is only available when subscribed to in the original API request or TwiML response. In other words, your TwiML or API request must also provide a status callback URL and the events you wish to receive.

TwiML Requested events are compatible with Webhook, Kinesis and Segment sinks. To learn more, you can get started with the Webhook, Kinesis or Segment quickstarts and refer to the product documentation.

Examples

1
{

2
  "specversion" : "1.0",

3
  "type" : "com.twilio.voice.twiml.call.requested",

4
  "source" : "AB00000000000000000000000001",

5
  "id" : "NO00000000000000000000000001",

6
  "dataschema" : "https://events-schemas.twilio.com/Voice.WebhookEvent/2",

7
  "datacontenttype" : "2025-10-08T07:17:02.363Z",

8
  "data" : {

9
    "sid" : "CA0000000000000000000000000000001",

10
    "requestDateCreated" : "Sun, 24 Aug 2025 13:49:54 +0000",

11
    "timestamp" : "2025-01-01T00:00:00.000Z",

12
    "eventSid" : "VW0000000000000000000000000000001",

13
    "request" : {

14
      "method" : "POST",

15
      "url" : "https://mycompany.com/an-endpoint",

16
      "parameters" : { }

17
    },

18
    "response" : {

19
      "responseCode" : 200,

20
      "requestDuration" : 140,

21
      "contentType" : "application/xml;charset=UTF-8",

22
      "responseBody" : "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz48UmVzcG9uc2U+PFNheT48L1NheT48UGF1c2UgbGVuZ3RoPSIxIi8+PFJlZGlyZWN0IG1ldGhvZD0iUE9TVCI+aHR0cHM6Ly9teWNvbXBhbnkuY29tL2FuLWVuZHBvaW50PC9SZWRpcmVjdD48L1Jlc3BvbnNlPg==",

23
      "dateCreated" : "Sun, 24 Aug 2025 13:49:54 +0000"

24
    }

25
  }

26
}

Versions