---
title: "10DLC status callback"
method: POST
path: "tenDlcStatusCallback"
tags: ["Campaign Registry"]
---

# 10DLC status callback

`POST tenDlcStatusCallback` (webhook)

Payload sent by SignalWire to your 10DLC Status Callback URL when the state of a 10DLC registration
object changes. Use this webhook to monitor the lifecycle of messaging brands, campaigns, number
assignment orders, and number assignments in real time.

Configure `status_callback_url` when
[creating a brand](/docs/apis/rest/campaign-registry/brands/create-brand),
[creating a campaign](/docs/apis/rest/campaign-registry/campaigns/create-campaign), or
[creating a number assignment order](/docs/apis/rest/campaign-registry/phone-number-assignments/create-order).

### Brand event types

| State transition | Event type | Description |
|------------------|------------|-------------|
| `pending` → `completed` | `brand_activated` | The brand has been successfully verified and activated. |
| `pending` → `unverified` | `brand_unverified` | Brand verification failed or additional information is required. |
| `unverified` → `completed` | `brand_activated` | The brand was previously unverified but is now active. |

### Campaign event types

| State transition | Event type | Description |
|------------------|------------|-------------|
| `pending` → `active` | `campaign_activated` | The campaign has been approved and is now active. |
| `active` → `inactive` | `campaign_deactivated` | The campaign has been deactivated and can no longer send. |

### Number assignment order event types

| State transition | Event type | Description |
|------------------|------------|-------------|
| `pending` → `processed` | `number_assignment_order_processed` | The order has been processed and numbers assigned. |

### Number assignment event types

| State transition | Event type | Description |
|------------------|------------|-------------|
| `pending` → `failed` | `number_assignment_failed` | The number was not assigned to the campaign. |
| `failed` → `pending` | `number_assignment_pending` | A failed assignment is being retried. |
| `pending` → `completed` | `number_assignment_activated` | The number has been successfully assigned to the campaign. |

Status callbacks are advisory, best-effort notifications — delivery can be delayed or fail silently, so don't gate time-critical actions on receiving one. See [Status callback reliability](/docs/platform/webhooks#status-callback-reliability).

## Payload

- object — Payload sent by SignalWire to your 10DLC Status Callback URL when the state of a 10DLC registration object changes. Use this webhook to monitor the lifecycle of messaging brands, campaigns, number assignment orders, and number assignments in real time. Configure `status_callback_url` when [creating a brand](/docs/apis/rest/campaign-registry/brands/create-brand), [creating a campaign](/docs/apis/rest/campaign-registry/campaigns/create-campaign), or [creating a number assignment order](/docs/apis/rest/campaign-registry/phone-number-assignments/create-order). ### Brand event types | State transition | Event type | Description | |------------------|------------|-------------| | `pending` → `completed` | `brand_activated` | The brand has been successfully verified and activated. | | `pending` → `unverified` | `brand_unverified` | Brand verification failed or additional information is required. | | `unverified` → `completed` | `brand_activated` | The brand was previously unverified but is now active. | ### Campaign event types | State transition | Event type | Description | |------------------|------------|-------------| | `pending` → `active` | `campaign_activated` | The campaign has been approved and is now active. | | `active` → `inactive` | `campaign_deactivated` | The campaign has been deactivated and can no longer send. | ### Number assignment order event types | State transition | Event type | Description | |------------------|------------|-------------| | `pending` → `processed` | `number_assignment_order_processed` | The order has been processed and numbers assigned. | ### Number assignment event types | State transition | Event type | Description | |------------------|------------|-------------| | `pending` → `failed` | `number_assignment_failed` | The number was not assigned to the campaign. | | `failed` → `pending` | `number_assignment_pending` | A failed assignment is being retried. | | `pending` → `completed` | `number_assignment_activated` | The number has been successfully assigned to the campaign. | Status callbacks are advisory, best-effort notifications — delivery can be delayed or fail silently, so don't gate time-critical actions on receiving one. See [Status callback reliability](/docs/platform/webhooks#status-callback-reliability).
  - `project_id` string, required — The unique ID of the project this object is associated with.
  - `event_at` string, required — The timestamp of when the event occurred, in ISO 8601 format.
  - `event_category` 'brand' | 'campaign' | 'number_assignment_order' | 'number_assignment', required — The category of the event.
  - `event_type` 'brand_activated' | 'brand_unverified' | 'campaign_activated' | 'campaign_deactivated' | 'number_assignment_order_processed' | 'number_assignment_failed' | 'number_assignment_pending' | 'number_assignment_activated', required — The specific type of event that occurred. One of: `brand_activated`, `brand_unverified`, `campaign_activated`, `campaign_deactivated`, `number_assignment_order_processed`, `number_assignment_failed`, `number_assignment_pending`, `number_assignment_activated`.
  - `state` string, required — The current state of the object after the event. Possible values depend on the object type.
  - `brand_id` string, required — The unique identifier for the brand. Present in all event types.
  - `campaign_id` string — The unique identifier for the campaign. Present in campaign, number assignment order, and number assignment events.
  - `number_assignment_order_id` string — The unique identifier for the number assignment order. Present in number assignment order and number assignment events.
  - `number_assignment_id` string — The unique identifier for the number assignment. Present only in number assignment events.
  - `phone_number_id` string — The unique identifier for the phone route itself. Present only in number assignment events.
  - `phone_number` string — The phone number in E.164 format. Present only in number assignment events.

## Acknowledgement `200`

Webhook received

---

[API](https://skmtc.net/signalwire/apis/signalwire-rest-api.md) · [All operations](https://skmtc.net/signalwire/apis/signalwire-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/signalwire/signalwire-rest-api/versions/05c5164b85c7/schema)