# Events

Returns a list of Events from your Twilio account.

**Sync Type: Incremental**

## Requirements

Before you connect Monad to Twilio, you need an Account SID and Auth token. Follow https://www.twilio.com/en-us/blog/better-twilio-authentication-csharp-twilio-api-keys to retrieve your credentials.

## Details

Monad uses the `StartDate` filter on the [API](https://www.twilio.com/docs/usage/monitor-events#read-multiple-event-resources) to determine which events to display. This field is updated every time a request to get events is successful with the last time a request to get events was initiated. If this was the first time requesting for data, a full sync of the data is performed. Monad also provides a way to specify the Replication Start Date, which would determine the initial value for this filter.

## Configuration
The following configuration defines the input parameters. Each field's specifications, such as type, requirements, and descriptions, are detailed below.

#### Settings

| Setting | Type | Required | Description |
|---------|------|----------|-------------|
| Actor SID | string | No | Only includes events initiated by this Actor. Useful for auditing actions taken by specific users or API credentials. |
| Replication Start Time | string | No | The date to start fetching data from. If not specified, no past records will be fetched. |
| Resource SID | string | No | Only include events that refer to this resource. Useful for discovering the history of a specific resource. |
| Event Type | string | No | Only includes events of a specific event type: https://www.twilio.com/docs/usage/monitor-events#event-types. |


#### Secrets

| Secret | Type | Required | Description |
|---------|------|----------|-------------|
| Account Sid | string | Yes | The unique identifier for your Twilio account. |
| Twilio Auth Token | string | Yes | The secret authentication token associated with your Twilio account. |



## Sample Record

```json
{
  "account_sid": "AC9e57c89e0bd49fb15218005acae4c496",
  "actor_sid": "USe979d3f2edbb5dbd3fbfa6f9062f844b",
  "actor_type": "twilio-admin",
  "description": "Security settings modified",
  "event_date": "2025-08-11T23:47:00.691412Z",
  "event_type": "user.created",
  "resource_sid": "SM1234567890abcdef1234567890abcdef",
  "resource_type": "user",
  "sid": "AE07d41a1e17b5e1ec34529649641173e5",
  "url": "https://monitor.twilio.com/v1/Events/AEfedcba0987654321fedcba0987654321",
  "source": "twilio",
  "source_ip_address": "125.39.6.118",
  "event_data": {
    "resource_properties": {
      "roles": {
        "updated": "Viewer",
        "previous": ""
      },
      "email": {
        "updated": "admin@company.com",
        "previous": "olduser@example.com"
      }
    }
  },
  "links": {
    "actor": "https://api.twilio.com/2010-04-01/Accounts/AC1234567890abcdef1234567890abcdef/Users/USe979d3f2edbb5dbd3fbfa6f9062f844b",
    "resource": "https://api.twilio.com/2010-04-01/Accounts/AC9e57c89e0bd49fb15218005acae4c496/OutgoingCallerIds/SM1234567890abcdef1234567890abcdef"
  }
}
```