# Twilio - Events API

> Twilio - Events API on Apizie: 22 endpoints (Retrieve a paginated list of all the available Event Types., Fetch a specific Event Type., Fetch a specific schema with its nested versions., Retrieve a paginated list of versions of the schema., …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://apizie.tech/v1/communication:twilio-twilio-events-v1/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `communication:twilio-twilio-events-v1`
- Category: Communication
- Status: byok
- Source: https://support.twilio.com
- Page: https://apizie.tech/api/communication/twilio-twilio-events-v1
- OpenAPI: https://apizie.tech/api/communication/twilio-twilio-events-v1/openapi.json

This is the public Twilio REST API.

## Endpoints

### Retrieve a paginated list of all the available Event Types.
`GET https://apizie.tech/v1/communication:twilio-twilio-events-v1/list-event-type` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| SchemaId | string | no | A string parameter filtering the results to return only the Event Types using a given schema. |
| PageSize | integer | no | How many resources to return in each list page. The default is 50, and the maximum is 1000. |
| Page | integer | no | The page index. This value is simply for client state. |
| PageToken | string | no | The page token. This is provided by the API. |

### Fetch a specific Event Type.
`GET https://apizie.tech/v1/communication:twilio-twilio-events-v1/fetch-event-type` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| Type | string | yes | A string that uniquely identifies this Event Type. |

### Fetch a specific schema with its nested versions.
`GET https://apizie.tech/v1/communication:twilio-twilio-events-v1/fetch-schema` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| Id | string | yes | The unique identifier of the schema. Each schema can have multiple versions, that share the same id. |

### Retrieve a paginated list of versions of the schema.
`GET https://apizie.tech/v1/communication:twilio-twilio-events-v1/list-schema-version` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| Id | string | yes | The unique identifier of the schema. Each schema can have multiple versions, that share the same id. |
| PageSize | integer | no | How many resources to return in each list page. The default is 50, and the maximum is 1000. |
| Page | integer | no | The page index. This value is simply for client state. |
| PageToken | string | no | The page token. This is provided by the API. |

### Fetch a specific schema and version.
`GET https://apizie.tech/v1/communication:twilio-twilio-events-v1/fetch-schema-version` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| Id | string | yes | The unique identifier of the schema. Each schema can have multiple versions, that share the same id. |
| SchemaVersion | integer | yes | The version of the schema |

### Fetch a specific Sink.
`GET https://apizie.tech/v1/communication:twilio-twilio-events-v1/fetch-sink` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| Sid | string | yes | A 34 character string that uniquely identifies this Sink. |

### Update a specific Sink
`POST https://apizie.tech/v1/communication:twilio-twilio-events-v1/update-sink` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| Sid | string | yes | A 34 character string that uniquely identifies this Sink. |
| body | object | no | Form fields as a JSON object |

### Delete a specific Sink.
`POST https://apizie.tech/v1/communication:twilio-twilio-events-v1/delete-sink` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| Sid | string | yes | A 34 character string that uniquely identifies this Sink. |

### Retrieve a paginated list of Sinks belonging to the account used to make the request.
`GET https://apizie.tech/v1/communication:twilio-twilio-events-v1/list-sink` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| InUse | boolean | no | A boolean query parameter filtering the results to return sinks used/not used by a subscription. |
| Status | string | no | A String query parameter filtering the results by status `initialized`, `validating`, `active` or `failed`. |
| PageSize | integer | no | How many resources to return in each list page. The default is 50, and the maximum is 1000. |
| Page | integer | no | The page index. This value is simply for client state. |
| PageToken | string | no | The page token. This is provided by the API. |

### Create a new Sink
`POST https://apizie.tech/v1/communication:twilio-twilio-events-v1/create-sink` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | Form fields as a JSON object |

### Create a new Sink Test Event for the given Sink.
`POST https://apizie.tech/v1/communication:twilio-twilio-events-v1/create-sink-test` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| Sid | string | yes | A 34 character string that uniquely identifies the Sink to be Tested. |

### Validate that a test event for a Sink was received.
`POST https://apizie.tech/v1/communication:twilio-twilio-events-v1/create-sink-validate` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| Sid | string | yes | A 34 character string that uniquely identifies the Sink being validated. |
| body | object | no | Form fields as a JSON object |

### Retrieve a list of all Subscribed Event types for a Subscription.
`GET https://apizie.tech/v1/communication:twilio-twilio-events-v1/list-subscribed-event` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| SubscriptionSid | string | yes | The unique SID identifier of the Subscription. |
| PageSize | integer | no | How many resources to return in each list page. The default is 50, and the maximum is 1000. |
| Page | integer | no | The page index. This value is simply for client state. |
| PageToken | string | no | The page token. This is provided by the API. |

### Add an event type to a Subscription.
`POST https://apizie.tech/v1/communication:twilio-twilio-events-v1/create-subscribed-event` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| SubscriptionSid | string | yes | The unique SID identifier of the Subscription. |
| body | object | no | Form fields as a JSON object |

### Read an Event for a Subscription.
`GET https://apizie.tech/v1/communication:twilio-twilio-events-v1/fetch-subscribed-event` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| SubscriptionSid | string | yes | The unique SID identifier of the Subscription. |
| Type | string | yes | Type of event being subscribed to. |

### Update an Event for a Subscription.
`POST https://apizie.tech/v1/communication:twilio-twilio-events-v1/update-subscribed-event` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| SubscriptionSid | string | yes | The unique SID identifier of the Subscription. |
| Type | string | yes | Type of event being subscribed to. |
| body | object | no | Form fields as a JSON object |

### Remove an event type from a Subscription.
`POST https://apizie.tech/v1/communication:twilio-twilio-events-v1/delete-subscribed-event` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| SubscriptionSid | string | yes | The unique SID identifier of the Subscription. |
| Type | string | yes | Type of event being subscribed to. |

### Retrieve a paginated list of Subscriptions belonging to the account used to make the request.
`GET https://apizie.tech/v1/communication:twilio-twilio-events-v1/list-subscription` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| SinkSid | string | no | The SID of the sink that the list of Subscriptions should be filtered by. |
| PageSize | integer | no | How many resources to return in each list page. The default is 50, and the maximum is 1000. |
| Page | integer | no | The page index. This value is simply for client state. |
| PageToken | string | no | The page token. This is provided by the API. |

### Create a new Subscription.
`POST https://apizie.tech/v1/communication:twilio-twilio-events-v1/create-subscription` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | Form fields as a JSON object |

### Fetch a specific Subscription.
`GET https://apizie.tech/v1/communication:twilio-twilio-events-v1/fetch-subscription` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| Sid | string | yes | A 34 character string that uniquely identifies this Subscription. |

### Update a Subscription.
`POST https://apizie.tech/v1/communication:twilio-twilio-events-v1/update-subscription` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| Sid | string | yes | A 34 character string that uniquely identifies this Subscription. |
| body | object | no | Form fields as a JSON object |

### Delete a specific Subscription.
`POST https://apizie.tech/v1/communication:twilio-twilio-events-v1/delete-subscription` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| Sid | string | yes | A 34 character string that uniquely identifies this Subscription. |

## Example
```
curl "https://apizie.tech/v1/communication:twilio-twilio-events-v1/list-event-type" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Twilio - Events API?
Create a free Apizie key, then send GET https://apizie.tech/v1/communication:twilio-twilio-events-v1/list-event-type with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Twilio - Events API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Twilio - Events itself also needs your own key from twilio.

### Can AI agents use the Twilio - Events API?
Yes. Add the Apizie MCP server (https://apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key communication:twilio-twilio-events-v1.

### What is the status of the Twilio - Events API?
Needs your own provider key (bring your own key)