Phone number change

The client.phone.changed notification reports the phone number change result: completed or failed. Change Phone Number is the API method that triggers this notification. When the status is failed, it also contains error_code and error_description.

client.phone.changed — completed

Sent on successful phone number change via API /api/v1/change_phone. data.state = completed.

{
  "event": "client.phone.changed",
  "event_version": 1,
  "event_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "timestamp": "2025-01-15T10:30:05Z",
  "data": {
    "state": "completed"
  }
}

client.phone.changed — failed

Sent on phone change failure. data.state = failed + error_code and error_description.

{
  "event": "client.phone.changed",
  "event_version": 1,
  "event_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
  "timestamp": "2025-01-15T10:30:05Z",
  "data": {
    "state": "failed",
    "error_code": "INVALID_PHONE",
    "error_description": "Invalid phone number format"
  }
}