number.quality_updated▾

number.quality_updated

A phone number's quality rating or messaging tier changed.

Your messaging tier caps how many unique contacts you can start conversations with per day. A tier cut mid-broadcast is the most common cause of a stalled send.

EVENTnumber.quality_updated
Payload
{
  "id": "evt_01JZQ6F5H7K9M1P3R5T7V9XZBD",
  "object": "event",
  "type": "number.quality_updated",
  "created_at": "2026-09-06T09:41:02.114Z",
  "api_version": "2026-09-01",
  "data": {
    "object": "phone_number",
    "id": "pn_01JZQ2E5R7T9V1X3Z5B7D9FHKM",
    "display_number": "+15550100200",
    "quality_rating": "YELLOW",
    "previous_quality_rating": "GREEN",
    "messaging_limit": "TIER_10K",
    "previous_messaging_limit": "TIER_100K",
    "status_at": "2026-09-06T10:11:00.000Z"
  }
}

Notable fields

quality_ratingenumrequired

New rating.

GREENYELLOWREDUNKNOWN

messaging_limitenumrequired

New daily unique-contact cap.

TIER_1KTIER_10KTIER_100KTIER_UNLIMITED

Previoustemplate.quality_updatedNextconversation.assigned