# TwiML

## Call Redirected

`com.twilio.voice.twiml.call.redirected`

> \[!NOTE]
>
> 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](/docs/events/webhook-quickstart), [Kinesis](/docs/events/eventstreams-quickstart) or [Segment](/docs/events/segment-quickstart) quickstarts and refer to the [product documentation](/docs/voice/api).

**Examples**

```json
{
  "specversion" : "1.0",
  "type" : "com.twilio.voice.twiml.call.redirected",
  "source" : "AB00000000000000000000000001",
  "id" : "NO00000000000000000000000001",
  "dataschema" : "https://events-schemas.twilio.com/Voice.WebhookEvent/2",
  "datacontenttype" : "2025-10-08T07:17:02.363Z",
  "data" : {
    "sid" : "CA0000000000000000000000000000001",
    "requestDateCreated" : "Sun, 24 Aug 2025 13:49:54 +0000",
    "timestamp" : "2025-01-01T00:00:00.000Z",
    "eventSid" : "VW0000000000000000000000000000001",
    "request" : {
      "method" : "POST",
      "url" : "https://mycompany.com/an-endpoint",
      "parameters" : { }
    },
    "response" : {
      "responseCode" : 200,
      "requestDuration" : 140,
      "contentType" : "application/xml;charset=UTF-8",
      "responseBody" : "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz48UmVzcG9uc2U+PFNheT48L1NheT48UGF1c2UgbGVuZ3RoPSIxIi8+PFJlZGlyZWN0IG1ldGhvZD0iUE9TVCI+aHR0cHM6Ly9teWNvbXBhbnkuY29tL2FuLWVuZHBvaW50PC9SZWRpcmVjdD48L1Jlc3BvbnNlPg==",
      "dateCreated" : "Sun, 24 Aug 2025 13:49:54 +0000"
    }
  }
}
```

**Versions**

#### v2 (latest)

> \[!NOTE]
>
> v2 only contains updates to the schema metadata. In other words, there are no new fields between v1 and v2.

* `string` **sid** (required). The unique SID identifier of the Call.
* `string` **requestDateCreated**. Date event created.
* `string` **timestamp**. Time of the event.
* `string` **eventSid**. Id of the event.
* `object` **request**. Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **method** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **url** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `object` **parameters** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
* `object` **response**. Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `integer` **responseCode** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `integer` **requestDuration** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **contentType** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **responseBody** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **dateCreated** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.

The full specification for version 2 is also available as a [JSON schema](https://events-schemas.twilio.com/Voice.WebhookEvent/2).

#### v1

* `string` **sid** (required). The unique SID identifier of the Call.
* `string` **requestDateCreated**. Date event created.
* `string` **timestamp**. Time of the event.
* `string` **eventSid**. Id of the event.
* `object` **request**. Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **method** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **url** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `object` **parameters** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
* `object` **response**. Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `integer` **responseCode** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `integer` **requestDuration** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **contentType** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **responseBody** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **dateCreated** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.

The full specification for version 1 is also available as a [JSON schema](https://events-schemas.twilio.com/Voice.WebhookEvent/1).

## Call Transferred

`com.twilio.voice.twiml.call.transferred`

> \[!NOTE]
>
> 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](/docs/events/webhook-quickstart), [Kinesis](/docs/events/eventstreams-quickstart) or [Segment](/docs/events/segment-quickstart) quickstarts and refer to the [product documentation](/docs/voice/api).

**Examples**

```json
{
  "specversion" : "1.0",
  "type" : "com.twilio.voice.twiml.call.transferred",
  "source" : "AB00000000000000000000000001",
  "id" : "NO00000000000000000000000001",
  "dataschema" : "https://events-schemas.twilio.com/Voice.WebhookEvent/2",
  "datacontenttype" : "2025-10-08T07:17:02.363Z",
  "data" : {
    "sid" : "CA0000000000000000000000000000001",
    "requestDateCreated" : "Sun, 24 Aug 2025 13:49:54 +0000",
    "timestamp" : "2025-01-01T00:00:00.000Z",
    "eventSid" : "VW0000000000000000000000000000001",
    "request" : {
      "method" : "POST",
      "url" : "https://mycompany.com/an-endpoint",
      "parameters" : { }
    },
    "response" : {
      "responseCode" : 200,
      "requestDuration" : 140,
      "contentType" : "application/xml;charset=UTF-8",
      "responseBody" : "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz48UmVzcG9uc2U+PFNheT48L1NheT48UGF1c2UgbGVuZ3RoPSIxIi8+PFJlZGlyZWN0IG1ldGhvZD0iUE9TVCI+aHR0cHM6Ly9teWNvbXBhbnkuY29tL2FuLWVuZHBvaW50PC9SZWRpcmVjdD48L1Jlc3BvbnNlPg==",
      "dateCreated" : "Sun, 24 Aug 2025 13:49:54 +0000"
    }
  }
}
```

**Versions**

#### v2 (latest)

> \[!NOTE]
>
> v2 only contains updates to the schema metadata. In other words, there are no new fields between v1 and v2.

* `string` **sid** (required). The unique SID identifier of the Call.
* `string` **requestDateCreated**. Date event created.
* `string` **timestamp**. Time of the event.
* `string` **eventSid**. Id of the event.
* `object` **request**. Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **method** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **url** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `object` **parameters** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
* `object` **response**. Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `integer` **responseCode** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `integer` **requestDuration** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **contentType** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **responseBody** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **dateCreated** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.

The full specification for version 2 is also available as a [JSON schema](https://events-schemas.twilio.com/Voice.WebhookEvent/2).

#### v1

* `string` **sid** (required). The unique SID identifier of the Call.
* `string` **requestDateCreated**. Date event created.
* `string` **timestamp**. Time of the event.
* `string` **eventSid**. Id of the event.
* `object` **request**. Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **method** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **url** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `object` **parameters** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
* `object` **response**. Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `integer` **responseCode** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `integer` **requestDuration** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **contentType** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **responseBody** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **dateCreated** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.

The full specification for version 1 is also available as a [JSON schema](https://events-schemas.twilio.com/Voice.WebhookEvent/1).

## Dial Finished

`com.twilio.voice.twiml.dial.finished`

> \[!NOTE]
>
> 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](/docs/events/webhook-quickstart), [Kinesis](/docs/events/eventstreams-quickstart) or [Segment](/docs/events/segment-quickstart) quickstarts and refer to the [product documentation](/docs/voice/api).

**Examples**

```json
{
  "specversion" : "1.0",
  "type" : "com.twilio.voice.twiml.dial.finished",
  "source" : "AB00000000000000000000000001",
  "id" : "NO00000000000000000000000001",
  "dataschema" : "https://events-schemas.twilio.com/Voice.WebhookEvent/2",
  "datacontenttype" : "2025-10-08T07:17:02.363Z",
  "data" : {
    "sid" : "CA0000000000000000000000000000001",
    "requestDateCreated" : "Sun, 24 Aug 2025 13:49:54 +0000",
    "timestamp" : "2025-01-01T00:00:00.000Z",
    "eventSid" : "VW0000000000000000000000000000001",
    "request" : {
      "method" : "POST",
      "url" : "https://mycompany.com/an-endpoint",
      "parameters" : { }
    },
    "response" : {
      "responseCode" : 200,
      "requestDuration" : 140,
      "contentType" : "application/xml;charset=UTF-8",
      "responseBody" : "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz48UmVzcG9uc2U+PFNheT48L1NheT48UGF1c2UgbGVuZ3RoPSIxIi8+PFJlZGlyZWN0IG1ldGhvZD0iUE9TVCI+aHR0cHM6Ly9teWNvbXBhbnkuY29tL2FuLWVuZHBvaW50PC9SZWRpcmVjdD48L1Jlc3BvbnNlPg==",
      "dateCreated" : "Sun, 24 Aug 2025 13:49:54 +0000"
    }
  }
}
```

**Versions**

#### v2 (latest)

> \[!NOTE]
>
> v2 only contains updates to the schema metadata. In other words, there are no new fields between v1 and v2.

* `string` **sid** (required). The unique SID identifier of the Call.
* `string` **requestDateCreated**. Date event created.
* `string` **timestamp**. Time of the event.
* `string` **eventSid**. Id of the event.
* `object` **request**. Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **method** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **url** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `object` **parameters** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
* `object` **response**. Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `integer` **responseCode** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `integer` **requestDuration** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **contentType** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **responseBody** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **dateCreated** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.

The full specification for version 2 is also available as a [JSON schema](https://events-schemas.twilio.com/Voice.WebhookEvent/2).

#### v1

* `string` **sid** (required). The unique SID identifier of the Call.
* `string` **requestDateCreated**. Date event created.
* `string` **timestamp**. Time of the event.
* `string` **eventSid**. Id of the event.
* `object` **request**. Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **method** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **url** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `object` **parameters** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
* `object` **response**. Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `integer` **responseCode** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `integer` **requestDuration** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **contentType** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **responseBody** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **dateCreated** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.

The full specification for version 1 is also available as a [JSON schema](https://events-schemas.twilio.com/Voice.WebhookEvent/1).

## Enqueue Finished

`com.twilio.voice.twiml.enqueue.finished`

> \[!NOTE]
>
> 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](/docs/events/webhook-quickstart), [Kinesis](/docs/events/eventstreams-quickstart) or [Segment](/docs/events/segment-quickstart) quickstarts and refer to the [product documentation](/docs/voice/api).

**Examples**

```json
{
  "specversion" : "1.0",
  "type" : "com.twilio.voice.twiml.enqueue.finished",
  "source" : "AB00000000000000000000000001",
  "id" : "NO00000000000000000000000001",
  "dataschema" : "https://events-schemas.twilio.com/Voice.WebhookEvent/2",
  "datacontenttype" : "2025-10-08T07:17:02.363Z",
  "data" : {
    "sid" : "CA0000000000000000000000000000001",
    "requestDateCreated" : "Sun, 24 Aug 2025 13:49:54 +0000",
    "timestamp" : "2025-01-01T00:00:00.000Z",
    "eventSid" : "VW0000000000000000000000000000001",
    "request" : {
      "method" : "POST",
      "url" : "https://mycompany.com/an-endpoint",
      "parameters" : { }
    },
    "response" : {
      "responseCode" : 200,
      "requestDuration" : 140,
      "contentType" : "application/xml;charset=UTF-8",
      "responseBody" : "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz48UmVzcG9uc2U+PFNheT48L1NheT48UGF1c2UgbGVuZ3RoPSIxIi8+PFJlZGlyZWN0IG1ldGhvZD0iUE9TVCI+aHR0cHM6Ly9teWNvbXBhbnkuY29tL2FuLWVuZHBvaW50PC9SZWRpcmVjdD48L1Jlc3BvbnNlPg==",
      "dateCreated" : "Sun, 24 Aug 2025 13:49:54 +0000"
    }
  }
}
```

**Versions**

#### v2 (latest)

> \[!NOTE]
>
> v2 only contains updates to the schema metadata. In other words, there are no new fields between v1 and v2.

* `string` **sid** (required). The unique SID identifier of the Call.
* `string` **requestDateCreated**. Date event created.
* `string` **timestamp**. Time of the event.
* `string` **eventSid**. Id of the event.
* `object` **request**. Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **method** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **url** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `object` **parameters** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
* `object` **response**. Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `integer` **responseCode** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `integer` **requestDuration** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **contentType** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **responseBody** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **dateCreated** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.

The full specification for version 2 is also available as a [JSON schema](https://events-schemas.twilio.com/Voice.WebhookEvent/2).

#### v1

* `string` **sid** (required). The unique SID identifier of the Call.
* `string` **requestDateCreated**. Date event created.
* `string` **timestamp**. Time of the event.
* `string` **eventSid**. Id of the event.
* `object` **request**. Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **method** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **url** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `object` **parameters** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
* `object` **response**. Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `integer` **responseCode** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `integer` **requestDuration** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **contentType** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **responseBody** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **dateCreated** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.

The full specification for version 1 is also available as a [JSON schema](https://events-schemas.twilio.com/Voice.WebhookEvent/1).

## Gather Finished

`com.twilio.voice.twiml.gather.finished`

> \[!NOTE]
>
> 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](/docs/events/webhook-quickstart), [Kinesis](/docs/events/eventstreams-quickstart) or [Segment](/docs/events/segment-quickstart) quickstarts and refer to the [product documentation](/docs/voice/api).

**Examples**

```json
{
  "specversion" : "1.0",
  "type" : "com.twilio.voice.twiml.gather.finished",
  "source" : "AB00000000000000000000000001",
  "id" : "NO00000000000000000000000001",
  "dataschema" : "https://events-schemas.twilio.com/Voice.WebhookEvent/2",
  "datacontenttype" : "2025-10-08T07:17:02.363Z",
  "data" : {
    "sid" : "CA0000000000000000000000000000001",
    "requestDateCreated" : "Sun, 24 Aug 2025 13:49:54 +0000",
    "timestamp" : "2025-01-01T00:00:00.000Z",
    "eventSid" : "VW0000000000000000000000000000001",
    "request" : {
      "method" : "POST",
      "url" : "https://mycompany.com/an-endpoint",
      "parameters" : { }
    },
    "response" : {
      "responseCode" : 200,
      "requestDuration" : 140,
      "contentType" : "application/xml;charset=UTF-8",
      "responseBody" : "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz48UmVzcG9uc2U+PFNheT48L1NheT48UGF1c2UgbGVuZ3RoPSIxIi8+PFJlZGlyZWN0IG1ldGhvZD0iUE9TVCI+aHR0cHM6Ly9teWNvbXBhbnkuY29tL2FuLWVuZHBvaW50PC9SZWRpcmVjdD48L1Jlc3BvbnNlPg==",
      "dateCreated" : "Sun, 24 Aug 2025 13:49:54 +0000"
    }
  }
}
```

**Versions**

#### v2 (latest)

> \[!NOTE]
>
> v2 only contains updates to the schema metadata. In other words, there are no new fields between v1 and v2.

* `string` **sid** (required). The unique SID identifier of the Call.
* `string` **requestDateCreated**. Date event created.
* `string` **timestamp**. Time of the event.
* `string` **eventSid**. Id of the event.
* `object` **request**. Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **method** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **url** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `object` **parameters** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
* `object` **response**. Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `integer` **responseCode** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `integer` **requestDuration** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **contentType** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **responseBody** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **dateCreated** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.

The full specification for version 2 is also available as a [JSON schema](https://events-schemas.twilio.com/Voice.WebhookEvent/2).

#### v1

* `string` **sid** (required). The unique SID identifier of the Call.
* `string` **requestDateCreated**. Date event created.
* `string` **timestamp**. Time of the event.
* `string` **eventSid**. Id of the event.
* `object` **request**. Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **method** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **url** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `object` **parameters** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
* `object` **response**. Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `integer` **responseCode** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `integer` **requestDuration** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **contentType** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **responseBody** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **dateCreated** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.

The full specification for version 1 is also available as a [JSON schema](https://events-schemas.twilio.com/Voice.WebhookEvent/1).

## Record Finished

`com.twilio.voice.twiml.record.finished`

> \[!NOTE]
>
> 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](/docs/events/webhook-quickstart), [Kinesis](/docs/events/eventstreams-quickstart) or [Segment](/docs/events/segment-quickstart) quickstarts and refer to the [product documentation](/docs/voice/api).

**Examples**

```json
{
  "specversion" : "1.0",
  "type" : "com.twilio.voice.twiml.record.finished",
  "source" : "AB00000000000000000000000001",
  "id" : "NO00000000000000000000000001",
  "dataschema" : "https://events-schemas.twilio.com/Voice.WebhookEvent/2",
  "datacontenttype" : "2025-10-08T07:17:02.363Z",
  "data" : {
    "sid" : "CA0000000000000000000000000000001",
    "requestDateCreated" : "Sun, 24 Aug 2025 13:49:54 +0000",
    "timestamp" : "2025-01-01T00:00:00.000Z",
    "eventSid" : "VW0000000000000000000000000000001",
    "request" : {
      "method" : "POST",
      "url" : "https://mycompany.com/an-endpoint",
      "parameters" : { }
    },
    "response" : {
      "responseCode" : 200,
      "requestDuration" : 140,
      "contentType" : "application/xml;charset=UTF-8",
      "responseBody" : "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz48UmVzcG9uc2U+PFNheT48L1NheT48UGF1c2UgbGVuZ3RoPSIxIi8+PFJlZGlyZWN0IG1ldGhvZD0iUE9TVCI+aHR0cHM6Ly9teWNvbXBhbnkuY29tL2FuLWVuZHBvaW50PC9SZWRpcmVjdD48L1Jlc3BvbnNlPg==",
      "dateCreated" : "Sun, 24 Aug 2025 13:49:54 +0000"
    }
  }
}
```

**Versions**

#### v2 (latest)

> \[!NOTE]
>
> v2 only contains updates to the schema metadata. In other words, there are no new fields between v1 and v2.

* `string` **sid** (required). The unique SID identifier of the Call.
* `string` **requestDateCreated**. Date event created.
* `string` **timestamp**. Time of the event.
* `string` **eventSid**. Id of the event.
* `object` **request**. Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **method** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **url** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `object` **parameters** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
* `object` **response**. Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `integer` **responseCode** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `integer` **requestDuration** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **contentType** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **responseBody** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **dateCreated** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.

The full specification for version 2 is also available as a [JSON schema](https://events-schemas.twilio.com/Voice.WebhookEvent/2).

#### v1

* `string` **sid** (required). The unique SID identifier of the Call.
* `string` **requestDateCreated**. Date event created.
* `string` **timestamp**. Time of the event.
* `string` **eventSid**. Id of the event.
* `object` **request**. Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **method** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **url** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `object` **parameters** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
* `object` **response**. Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `integer` **responseCode** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `integer` **requestDuration** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **contentType** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **responseBody** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **dateCreated** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.

The full specification for version 1 is also available as a [JSON schema](https://events-schemas.twilio.com/Voice.WebhookEvent/1).

## Request Failed

`com.twilio.voice.twiml.request.failed`

> \[!NOTE]
>
> 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](/docs/events/webhook-quickstart) or [Kinesis](/docs/events/eventstreams-quickstart) quickstarts and refer to the [product documentation](/docs/voice/api).

**Examples**

```json
{
  "specversion" : "1.0",
  "type" : "com.twilio.voice.twiml.request.failed",
  "source" : "AB00000000000000000000000001",
  "id" : "NO00000000000000000000000001",
  "dataschema" : "https://events-schemas.twilio.com/Voice.WebhookEvent/2",
  "datacontenttype" : "2025-10-08T07:17:02.363Z",
  "data" : {
    "sid" : "CA0000000000000000000000000000001",
    "requestDateCreated" : "Sun, 24 Aug 2025 13:49:54 +0000",
    "timestamp" : "2025-01-01T00:00:00.000Z",
    "eventSid" : "VW0000000000000000000000000000001",
    "request" : {
      "method" : "POST",
      "url" : "https://mycompany.com/an-endpoint",
      "parameters" : { }
    },
    "response" : {
      "responseCode" : 200,
      "requestDuration" : 140,
      "contentType" : "application/xml;charset=UTF-8",
      "responseBody" : "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz48UmVzcG9uc2U+PFNheT48L1NheT48UGF1c2UgbGVuZ3RoPSIxIi8+PFJlZGlyZWN0IG1ldGhvZD0iUE9TVCI+aHR0cHM6Ly9teWNvbXBhbnkuY29tL2FuLWVuZHBvaW50PC9SZWRpcmVjdD48L1Jlc3BvbnNlPg==",
      "dateCreated" : "Sun, 24 Aug 2025 13:49:54 +0000"
    }
  }
}
```

**Versions**

#### v2 (latest)

> \[!NOTE]
>
> v2 only contains updates to the schema metadata. In other words, there are no new fields between v1 and v2.

* `string` **sid** (required). The unique SID identifier of the Call.
* `string` **requestDateCreated**. Date event created.
* `string` **timestamp**. Time of the event.
* `string` **eventSid**. Id of the event.
* `object` **request**. Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **method** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **url** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `object` **parameters** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
* `object` **response**. Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `integer` **responseCode** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `integer` **requestDuration** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **contentType** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **responseBody** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **dateCreated** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.

The full specification for version 2 is also available as a [JSON schema](https://events-schemas.twilio.com/Voice.WebhookEvent/2).

#### v1

* `string` **sid** (required). The unique SID identifier of the Call.
* `string` **requestDateCreated**. Date event created.
* `string` **timestamp**. Time of the event.
* `string` **eventSid**. Id of the event.
* `object` **request**. Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **method** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **url** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `object` **parameters** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
* `object` **response**. Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `integer` **responseCode** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `integer` **requestDuration** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **contentType** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **responseBody** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **dateCreated** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.

The full specification for version 1 is also available as a [JSON schema](https://events-schemas.twilio.com/Voice.WebhookEvent/1).

## Requested

`com.twilio.voice.twiml.call.requested`

> \[!NOTE]
>
> 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](/docs/events/webhook-quickstart), [Kinesis](/docs/events/eventstreams-quickstart) or [Segment](/docs/events/segment-quickstart) quickstarts and refer to the [product documentation](/docs/voice/api).

**Examples**

```json
{
  "specversion" : "1.0",
  "type" : "com.twilio.voice.twiml.call.requested",
  "source" : "AB00000000000000000000000001",
  "id" : "NO00000000000000000000000001",
  "dataschema" : "https://events-schemas.twilio.com/Voice.WebhookEvent/2",
  "datacontenttype" : "2025-10-08T07:17:02.363Z",
  "data" : {
    "sid" : "CA0000000000000000000000000000001",
    "requestDateCreated" : "Sun, 24 Aug 2025 13:49:54 +0000",
    "timestamp" : "2025-01-01T00:00:00.000Z",
    "eventSid" : "VW0000000000000000000000000000001",
    "request" : {
      "method" : "POST",
      "url" : "https://mycompany.com/an-endpoint",
      "parameters" : { }
    },
    "response" : {
      "responseCode" : 200,
      "requestDuration" : 140,
      "contentType" : "application/xml;charset=UTF-8",
      "responseBody" : "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz48UmVzcG9uc2U+PFNheT48L1NheT48UGF1c2UgbGVuZ3RoPSIxIi8+PFJlZGlyZWN0IG1ldGhvZD0iUE9TVCI+aHR0cHM6Ly9teWNvbXBhbnkuY29tL2FuLWVuZHBvaW50PC9SZWRpcmVjdD48L1Jlc3BvbnNlPg==",
      "dateCreated" : "Sun, 24 Aug 2025 13:49:54 +0000"
    }
  }
}
```

**Versions**

#### v2 (latest)

> \[!NOTE]
>
> v2 only contains updates to the schema metadata. In other words, there are no new fields between v1 and v2.

* `string` **sid** (required). The unique SID identifier of the Call.
* `string` **requestDateCreated**. Date event created.
* `string` **timestamp**. Time of the event.
* `string` **eventSid**. Id of the event.
* `object` **request**. Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **method** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **url** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `object` **parameters** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
* `object` **response**. Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `integer` **responseCode** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `integer` **requestDuration** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **contentType** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **responseBody** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **dateCreated** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.

The full specification for version 2 is also available as a [JSON schema](https://events-schemas.twilio.com/Voice.WebhookEvent/2).

#### v1

* `string` **sid** (required). The unique SID identifier of the Call.
* `string` **requestDateCreated**. Date event created.
* `string` **timestamp**. Time of the event.
* `string` **eventSid**. Id of the event.
* `object` **request**. Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **method** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **url** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `object` **parameters** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
* `object` **response**. Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `integer` **responseCode** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `integer` **requestDuration** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **contentType** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **responseBody** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.
  * `string` **dateCreated** (required). Https://www.twilio.com/docs/voice/api/call-event-resource.

The full specification for version 1 is also available as a [JSON schema](https://events-schemas.twilio.com/Voice.WebhookEvent/1).