# contact.changed_number

HTML: https://www.app2email.com/docs/api/webhooks/contact.changed_number · Index: https://www.app2email.com/docs/api/llms.txt

A contact changed their WhatsApp number, or their business-scoped user id changed.

Group: Contacts. Header `X-App2email-Event: contact.changed_number`. 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 | one of: `user_changed_number`, `user_changed_user_id` |
| `data.previous` | object | yes |  |
| `data.previous.phone` | string |  |  |
| `data.previous.user_id` | string |  |  |
| `data.new` | object | yes |  |
| `data.new.phone` | string |  |  |
| `data.new.user_id` | string |  |  |
| `data.name` | string |  |  |
| `data.body` | string |  | WhatsApp's text, eg 'User Ann changed from ... to ...'. |
| `data.message_id` | string |  |  |
| `data.conversation_url` | string |  |  |
| `data.timestamp` | string |  |  |
| `data.whatsapp` | object |  | Meta's object, unchanged.; any keys |

## Samples

### number

```json
{
  "id": "evt_Pa3k9m2Lw8Rt5Yp1Zs03",
  "type": "contact.changed_number",
  "created": "2026-11-06T01:00:00.000Z",
  "number": "4976659348270",
  "data": {
    "change": "user_changed_number",
    "previous": {
      "phone": "61412345678",
      "user_id": "AU.9876543210987654"
    },
    "new": {
      "phone": "61498765432",
      "user_id": "AU.1234567890123456"
    },
    "name": "Sample Contact",
    "body": "User Sample Contact changed from 61412345678 to 61498765432",
    "message_id": "wamid.HBgLNjE0MTIzNDU2NzgVAgARGBJTQU1QTEVfVEVTVF9FVkVOVAA=",
    "conversation_url": "https://www.app2email.com/conversation/61412345678_4976659348270_SAMPLEk3XbQ9rTzP2mW",
    "timestamp": "2026-11-06T01:00:00.000Z"
  }
}
```

### user id

```json
{
  "id": "evt_Pa3k9m2Lw8Rt5Yp1Zs04",
  "type": "contact.changed_number",
  "created": "2026-11-06T01:00:00.000Z",
  "number": "4976659348270",
  "data": {
    "change": "user_changed_user_id",
    "previous": {
      "user_id": "AU.9876543210987654"
    },
    "new": {
      "user_id": "AU.1234567890123456"
    },
    "message_id": "wamid.HBgLNjE0MTIzNDU2NzgVAgARGBJTQU1QTEVfVEVTVF9FVkVOVAA=",
    "timestamp": "2026-11-06T01:00:00.000Z"
  }
}
```

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