# Template Approval

## Updated

`com.twilio.messaging.template.approval.updated`

Template Approval Updated 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/whatsapp/api/events).

**Examples**

```json
{
  "specversion" : "1.0",
  "type" : "com.twilio.messaging.template.approval.updated",
  "source" : "AB00000000000000000000000001",
  "id" : "NO00000000000000000000000001",
  "dataschema" : "https://events-schemas.twilio.com/Messaging.ApprovalUpdated/1",
  "datacontenttype" : "2025-10-08T07:17:02.363Z",
  "data" : {
    "type" : "category_update",
    "accountSid" : "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "dateUpdated" : "2025-05-29T18:21:32Z",
    "channel" : "whatsapp",
    "template" : {
      "sid" : "HXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
      "friendlyName" : "owl_update",
      "externalTemplateName" : "owl_update_hx123456",
      "language" : "en",
      "previousValue" : "utility",
      "currentValue" : "marketing"
    }
  }
}
```

```json
{
  "specversion" : "1.0",
  "type" : "com.twilio.messaging.template.approval.updated",
  "source" : "AB00000000000000000000000001",
  "id" : "NO00000000000000000000000001",
  "dataschema" : "https://events-schemas.twilio.com/Messaging.ApprovalUpdated/1",
  "datacontenttype" : "2025-10-08T07:17:02.363Z",
  "data" : {
    "type" : "status_update",
    "accountSid" : "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "dateUpdated" : "2025-05-29T18:21:32Z",
    "channel" : "whatsapp",
    "template" : {
      "sid" : "HXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
      "friendlyName" : "owl_update",
      "externalTemplateName" : "owl_update_hx123456",
      "language" : "en",
      "previousValue" : "approved",
      "currentValue" : "paused"
    }
  }
}
```

```json
{
  "specversion" : "1.0",
  "type" : "com.twilio.messaging.template.approval.updated",
  "source" : "AB00000000000000000000000001",
  "id" : "NO00000000000000000000000001",
  "dataschema" : "https://events-schemas.twilio.com/Messaging.ApprovalUpdated/1",
  "datacontenttype" : "2025-10-08T07:17:02.363Z",
  "data" : {
    "type" : "quality_update",
    "accountSid" : "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "dateUpdated" : "2025-05-29T18:21:32Z",
    "channel" : "whatsapp",
    "template" : {
      "sid" : "HXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
      "friendlyName" : "owl_update",
      "externalTemplateName" : "owl_update_hx123456",
      "language" : "en",
      "previousValue" : "green",
      "currentValue" : "yellow"
    }
  }
}
```

```json
{
  "specversion" : "1.0",
  "type" : "com.twilio.messaging.template.approval.updated",
  "source" : "AB00000000000000000000000001",
  "id" : "NO00000000000000000000000001",
  "dataschema" : "https://events-schemas.twilio.com/Messaging.ApprovalUpdated/1",
  "datacontenttype" : "2025-10-08T07:17:02.363Z",
  "data" : {
    "type" : "direct_send_category_notice",
    "accountSid" : "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "dateUpdated" : "2025-05-29T18:21:32Z",
    "status" : "DIRECT_SEND_UTILITY_MESSAGE_CATEGORY_NOTICE",
    "template" : {
      "sid" : "HXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
      "friendlyName" : "owl_update",
      "externalTemplateName" : "owl_update_hx123456",
      "language" : "en",
      "previousValue" : "utility",
      "currentValue" : "marketing"
    }
  }
}
```

```json
{
  "specversion" : "1.0",
  "type" : "com.twilio.messaging.template.approval.updated",
  "source" : "AB00000000000000000000000001",
  "id" : "NO00000000000000000000000001",
  "dataschema" : "https://events-schemas.twilio.com/Messaging.ApprovalUpdated/1",
  "datacontenttype" : "2025-10-08T07:17:02.363Z",
  "data" : {
    "type" : "direct_send_abuse_update",
    "accountSid" : "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "dateUpdated" : "2025-05-29T18:21:32Z",
    "status" : "DIRECT_SEND_UTILITY_CATEGORY_ABUSE_WARN",
    "dateExpiring" : "2025-06-13T18:21:32Z"
  }
}
```

```json
{
  "specversion" : "1.0",
  "type" : "com.twilio.messaging.template.approval.updated",
  "source" : "AB00000000000000000000000001",
  "id" : "NO00000000000000000000000001",
  "dataschema" : "https://events-schemas.twilio.com/Messaging.ApprovalUpdated/1",
  "datacontenttype" : "2025-10-08T07:17:02.363Z",
  "data" : {
    "type" : "direct_send_abuse_update",
    "accountSid" : "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "dateUpdated" : "2025-05-29T18:21:32Z",
    "status" : "DIRECT_SEND_UTILITY_CATEGORY_ABUSE_STRIKE_1",
    "dateExpiring" : "2025-06-13T18:21:32Z"
  }
}
```

```json
{
  "specversion" : "1.0",
  "type" : "com.twilio.messaging.template.approval.updated",
  "source" : "AB00000000000000000000000001",
  "id" : "NO00000000000000000000000001",
  "dataschema" : "https://events-schemas.twilio.com/Messaging.ApprovalUpdated/1",
  "datacontenttype" : "2025-10-08T07:17:02.363Z",
  "data" : {
    "type" : "direct_send_abuse_update",
    "accountSid" : "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "dateUpdated" : "2025-05-29T18:21:32Z",
    "status" : "DIRECT_SEND_UTILITY_CATEGORY_ABUSE_OFFBOARD",
    "dateExpiring" : "2025-06-13T18:21:32Z"
  }
}
```

**Versions**

#### v1 (latest)

* `string` **type** (required). Type of update: `category_update`, `status_update`, `quality_update`, `direct_send_category_notice`, or `direct_send_abuse_update`.
* `string` **accountSid** (required). Identifier of the Twilio account.
* `string` **dateUpdated** (required). Timestamp when the update occurred in ISO 8601 format.
* `string` **channel**. Messaging channel for the template (e.g., `whatsapp`). Required for template approval updates.
* `string` **status**. Direct Send capabilities status (e.g., `DIRECT_SEND_UTILITY_MESSAGE_CATEGORY_NOTICE`, `DIRECT_SEND_UTILITY_CATEGORY_ABUSE_WARN`, `DIRECT_SEND_UTILITY_CATEGORY_ABUSE_STRIKE_1`, `DIRECT_SEND_UTILITY_CATEGORY_ABUSE_OFFBOARD`). Required for `direct_send_abuse_update type`.
* `string` **dateExpiring**. Expiration date for Direct Send capabilities status in ISO 8601 format. Required only for `DIRECT_SEND_UTILITY_CATEGORY_ABUSE_STRIKE_1`, `DIRECT_SEND_UTILITY_CATEGORY_ABUSE_STRIKE_2`, and `DIRECT_SEND_UTILITY_CATEGORY_ABUSE_STRIKE_2`.
* `object` **template**. Template information and update details. Required for template approval updates.
  * `string` **sid**. Template SID.
  * `string` **friendlyName**. User-friendly name for the template.
  * `string` **externalTemplateName**. External template name from the downstream provider.
  * `string` **language**. Language code for the template (e.g., `en`, `es`).
  * `string` **previousValue**. Previous value before the update.
  * `string` **currentValue**. Current value after the update.

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