10DLC status callback

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, creating a campaign, or creating a number assignment 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.

Payload

The payload of this webhook request is an object.

project_idstringRequired

The unique ID of the project this object is associated with.

event_atstringRequired

The timestamp of when the event occurred, in ISO 8601 format.

event_categoryenumRequired

The category of the event.

Allowed values:

event_typeenumRequired

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.

statestringRequired

The current state of the object after the event. Possible values depend on the object type.

brand_idstringRequired

The unique identifier for the brand. Present in all event types.

campaign_idstringOptional

The unique identifier for the campaign. Present in campaign, number assignment order, and number assignment events.

number_assignment_order_idstringOptional

The unique identifier for the number assignment order. Present in number assignment order and number assignment events.

number_assignment_idstringOptional

The unique identifier for the number assignment. Present only in number assignment events.

phone_number_idstringOptional

The unique identifier for the phone route itself. Present only in number assignment events.

phone_numberstringOptional

The phone number in E.164 format. Present only in number assignment events.

Response

200

Webhook received