Webhook events

Event	When it fires	Typical use
`phone_number.activated`	Number active after payment	Enable dialing in your app
`phone_number.past_due`	Renewal overdue	Alert billing
`phone_number.suspended`	Suspended for non-payment	Block outbound
`phone_number.released`	Number returned to catalog	Clean up config

Event

When it fires

Typical use

phone_number.activated

Number active after payment

Enable dialing in your app

phone_number.past_due

Renewal overdue

Alert billing

phone_number.suspended

Suspended for non-payment

Block outbound

phone_number.released

Number returned to catalog

Clean up config

Payload examples

phone_number.activated

{
  "event": "phone_number.activated",
  "workspaceId": "clxx123...",
  "instanceId": "",
  "timestamp": "2026-06-01T10:00:00.000Z",
  "data": {
    "phoneNumberId": "clxx_pn_1",
    "phoneE164": "+5511987654321",
    "status": "ACTIVE"
  }
}

phone_number.past_due

{
  "event": "phone_number.past_due",
  "workspaceId": "clxx123...",
  "instanceId": "",
  "timestamp": "2026-06-15T10:00:00.000Z",
  "data": {
    "phoneNumberId": "clxx_pn_1",
    "phoneE164": "+5511987654321",
    "status": "PAST_DUE"
  }
}

phone_number.suspended

{
  "event": "phone_number.suspended",
  "workspaceId": "clxx123...",
  "instanceId": "",
  "timestamp": "2026-06-20T10:00:00.000Z",
  "data": {
    "phoneNumberId": "clxx_pn_1",
    "phoneE164": "+5511987654321",
    "status": "SUSPENDED"
  }
}

phone_number.released

{
  "event": "phone_number.released",
  "workspaceId": "clxx123...",
  "instanceId": "",
  "timestamp": "2026-07-01T10:00:00.000Z",
  "data": {
    "phoneNumberId": "clxx_pn_1",
    "phoneE164": "+5511987654321",
    "status": "RELEASED"
  }
}

Voice

Phone numbers

In short

Events

Payload examples

Next steps

​In short

​Events

​Payload examples

​Next steps

In short

Events

Payload examples

Next steps