# Call API Request

## Created

`com.twilio.voice.api-request.call.created`

> \[!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.

Call API Request Created 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.api-request.call.created",
  "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).

## Modified

`com.twilio.voice.api-request.call.modified`

> \[!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.

Call API Request Modified 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.api-request.call.modified",
  "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).