> ## Documentation Index
> Fetch the complete documentation index at: https://docs.notifique.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhook events

> phone_number.activated, past_due, suspended, and released, contracted number lifecycle.

<Tip>
  **`phone_number.*`** events notify about **billing and number status**, not **`voice.call.*`** (active calls).
</Tip>

## In short

* Fired when a **contracted number's lifecycle** changes (payment, suspension, release).
* `instanceId` is **empty** (numbers don't use channel instances).
* Configure under **Integrations → Webhooks**, see [Webhooks](/en/guides/webhooks/index).

For **call** events (`voice.call.*`), see [Webhook events, Voice](/en/voice-api/como-funciona/eventos-do-webhooks).

***

## 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            |

***

## Payload examples

<AccordionGroup>
  <Accordion title="phone_number.activated">
    ```json theme={null}
    {
      "event": "phone_number.activated",
      "workspaceId": "clxx123...",
      "instanceId": "",
      "timestamp": "2026-06-01T10:00:00.000Z",
      "data": {
        "phoneNumberId": "clxx_pn_1",
        "phoneE164": "+5511987654321",
        "status": "ACTIVE"
      }
    }
    ```
  </Accordion>

  <Accordion title="phone_number.past_due">
    ```json theme={null}
    {
      "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"
      }
    }
    ```
  </Accordion>

  <Accordion title="phone_number.suspended">
    ```json theme={null}
    {
      "event": "phone_number.suspended",
      "workspaceId": "clxx123...",
      "instanceId": "",
      "timestamp": "2026-06-20T10:00:00.000Z",
      "data": {
        "phoneNumberId": "clxx_pn_1",
        "phoneE164": "+5511987654321",
        "status": "SUSPENDED"
      }
    }
    ```
  </Accordion>

  <Accordion title="phone_number.released">
    ```json theme={null}
    {
      "event": "phone_number.released",
      "workspaceId": "clxx123...",
      "instanceId": "",
      "timestamp": "2026-07-01T10:00:00.000Z",
      "data": {
        "phoneNumberId": "clxx_pn_1",
        "phoneE164": "+5511987654321",
        "status": "RELEASED"
      }
    }
    ```
  </Accordion>
</AccordionGroup>

***

## Next steps

* [Quick Start](/en/phone-numbers-api/como-funciona/quick-start)
* [Introduction](/en/phone-numbers-api/como-funciona/introducao)
* [Webhook events, Voice](/en/voice-api/como-funciona/eventos-do-webhooks)