# number.updated

HTML: https://www.app2email.com/docs/api/webhooks/number.updated · Index: https://www.app2email.com/docs/api/llms.txt

WhatsApp changed something about the number or its account: quality, messaging limit, throughput, display name, status, restriction, connection ...

Group: Number. Header `X-App2email-Event: number.updated`. 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.change` | string | yes | phone_number_quality_update: quality (FLAGGED, UNFLAGGED), messaging_limit (UPGRADE, DOWNGRADE), onboarding (the first limit), throughput (THROUGHPUT_UPGRADE); new_value is then the limit, eg TIER_10K or TIER_UNLIMITED.; one of: `quality`, `messaging_limit`, `onboarding`, `throughput`, `display_name`, `account_status`, `account_review`, `restriction`, `violation`, `username`, `capability`, `connection`, `marketing_messages_onboarding`, `security`, `account` |
| `data.previous_value` | string |  |  |
| `data.new_value` | string |  |  |
| `data.details` | object |  | What WhatsApp sent with it (event, decision, rejection_reason, restriction_info ...).; any keys |
| `data.next_step` | string |  | reconnect: press Reconnect WhatsApp on the dashboard (a new display name, or the connection was lost).; one of: `reconnect` |
| `data.whatsapp_field` | string | yes | Meta's webhook field, eg phone_number_quality_update or account_update. |
| `data.timestamp` | string |  |  |

## Samples

### messaging limit

```json
{
  "id": "evt_Pa3k9m2Lw8Rt5Yp1Zs05",
  "type": "number.updated",
  "created": "2026-11-06T01:00:00.000Z",
  "number": "4976659348270",
  "data": {
    "change": "messaging_limit",
    "previous_value": "TIER_2K",
    "new_value": "TIER_10K",
    "details": {
      "event": "UPGRADE"
    },
    "whatsapp_field": "phone_number_quality_update",
    "timestamp": "2026-11-06T01:00:00.000Z"
  }
}
```

### throughput

```json
{
  "id": "evt_Pa3k9m2Lw8Rt5Yp1Zs018",
  "type": "number.updated",
  "created": "2026-11-06T01:00:00.000Z",
  "number": "4976659348270",
  "data": {
    "change": "throughput",
    "new_value": "TIER_UNLIMITED",
    "details": {
      "event": "THROUGHPUT_UPGRADE"
    },
    "whatsapp_field": "phone_number_quality_update",
    "timestamp": "2026-11-06T01:00:00.000Z"
  }
}
```

### display name

```json
{
  "id": "evt_Pa3k9m2Lw8Rt5Yp1Zs06",
  "type": "number.updated",
  "created": "2026-11-06T01:00:00.000Z",
  "number": "4976659348270",
  "data": {
    "change": "display_name",
    "previous_value": "Sample Shop",
    "new_value": "Sample Shop Sydney",
    "details": {
      "decision": "APPROVED"
    },
    "next_step": "reconnect",
    "whatsapp_field": "phone_number_name_update",
    "timestamp": "2026-11-06T01:00:00.000Z"
  }
}
```

### connection

```json
{
  "id": "evt_Pa3k9m2Lw8Rt5Yp1Zs07",
  "type": "number.updated",
  "created": "2026-11-06T01:00:00.000Z",
  "number": "4976659348270",
  "data": {
    "change": "connection",
    "new_value": "access_removed",
    "details": {
      "event": "PARTNER_REMOVED"
    },
    "next_step": "reconnect",
    "whatsapp_field": "account_update",
    "timestamp": "2026-11-06T01:00:00.000Z"
  }
}
```

### restriction

```json
{
  "id": "evt_Pa3k9m2Lw8Rt5Yp1Zs08",
  "type": "number.updated",
  "created": "2026-11-06T01:00:00.000Z",
  "number": "4976659348270",
  "data": {
    "change": "restriction",
    "new_value": "RESTRICTED_BIZ_INITIATED_MESSAGING",
    "details": {
      "event": "ACCOUNT_RESTRICTION",
      "restriction_info": [
        {
          "restriction_type": "RESTRICTED_BIZ_INITIATED_MESSAGING",
          "expiration": 1762560000
        }
      ]
    },
    "whatsapp_field": "account_update",
    "timestamp": "2026-11-06T01:00:00.000Z"
  }
}
```

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