# template.status_changed

HTML: https://www.app2email.com/docs/api/webhooks/template.status_changed · Index: https://www.app2email.com/docs/api/llms.txt

WhatsApp approved, rejected, paused or disabled a template, changed its quality or category, or it was edited (change components). WABA-wide: every number gets it.

Group: Templates. Header `X-App2email-Event: template.status_changed`. Inside the envelope `{id, type, created, number, test?, data}` ([envelope, headers, signature](https://www.app2email.com/docs/api/webhooks.md)). Every webhook of the number gets every number event: filter by `type`.

## data

| Field | Type | Required | Notes |
| --- | --- | --- | --- |
| `data.template` | object | yes |  |
| `data.template.name` | string |  |  |
| `data.template.language` | string |  |  |
| `data.template.id` | string |  |  |
| `data.status` | string | yes |  |
| `data.change` | string |  | The Meta webhook field for changes other than a status; components: the template was edited (status COMPONENTS_UPDATED). |
| `data.previous_value` | string |  |  |
| `data.new_value` | string |  |  |
| `data.reason` | string |  |  |
| `data.can_send` | boolean |  |  |
| `data.components` | object |  |  |
| `data.components.header` | string |  |  |
| `data.components.body` | string |  |  |
| `data.components.footer` | string |  |  |
| `data.components.buttons` | object[] |  |  |
| `data.components.buttons.type` | string |  |  |
| `data.components.buttons.text` | string |  |  |
| `data.components.buttons.url` | string |  |  |
| `data.components.buttons.phone_number` | string |  |  |
| `data.timestamp` | string |  |  |

## Samples

### approved

```json
{
  "id": "evt_Xq3k9m2Lw8Rt5Yp1Zs01",
  "type": "template.status_changed",
  "created": "2026-11-06T01:00:00.000Z",
  "number": "4976659348270",
  "data": {
    "template": {
      "name": "order_update",
      "language": "en",
      "id": "1234567890123456"
    },
    "status": "APPROVED",
    "can_send": true,
    "timestamp": "2026-11-06T01:00:00.000Z"
  }
}
```

### components

```json
{
  "id": "evt_Xq3k9m2Lw8Rt5Yp1Zs02",
  "type": "template.status_changed",
  "created": "2026-11-06T01:00:00.000Z",
  "number": "4976659348270",
  "data": {
    "template": {
      "name": "order_update",
      "language": "en",
      "id": "1234567890123456"
    },
    "status": "COMPONENTS_UPDATED",
    "change": "components",
    "components": {
      "header": "Your order",
      "body": "Hi {{1}}, your order {{2}} is on its way.",
      "buttons": [
        {
          "type": "URL",
          "text": "Track",
          "url": "https://www.example.com/track"
        }
      ]
    },
    "timestamp": "2026-11-06T01:00:00.000Z"
  }
}
```

## Caused by

- [Create a template and submit it for approval](https://www.app2email.com/docs/api/templates/create-template.md): `POST /v1/{number}/templates`
- [Edit a template (components, category, TTL, max price)](https://www.app2email.com/docs/api/templates/edit-template.md): `PATCH /v1/{number}/templates/{name}`
- [Delete a template (every language, or one)](https://www.app2email.com/docs/api/templates/delete-template.md): `DELETE /v1/{number}/templates/{name}`
- [Delete several templates at once (all or nothing)](https://www.app2email.com/docs/api/templates/delete-templates.md): `POST /v1/{number}/templates/delete`
- [Archive a template (deleted by WhatsApp after 28 days)](https://www.app2email.com/docs/api/templates/archive-template.md): `POST /v1/{number}/templates/{name}/archive`
- [Unarchive a template](https://www.app2email.com/docs/api/templates/unarchive-template.md): `POST /v1/{number}/templates/{name}/unarchive`
- [Create or update an authentication template in many languages](https://www.app2email.com/docs/api/templates/upsert-auth-template.md): `PUT /v1/{number}/templates/{name}/authentication`

Send it to your URL: https://www.app2email.com/docs/api/webhooks/tester?type=template.status_changed
