Sign in

v77

latestOpenAPI 3.1.0MITraw.githubusercontent.com2026-08-012528701.8 MB
Campaign Registry

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 transitionEvent typeDescription
pending → completedbrand_activatedThe brand has been successfully verified and activated.
pending → unverifiedbrand_unverifiedBrand verification failed or additional information is required.
unverified → completedbrand_activatedThe brand was previously unverified but is now active.

Campaign event types

State transitionEvent typeDescription
pending → activecampaign_activatedThe campaign has been approved and is now active.
active → inactivecampaign_deactivatedThe campaign has been deactivated and can no longer send.

Number assignment order event types

State transitionEvent typeDescription
pending → processednumber_assignment_order_processedThe order has been processed and numbers assigned.

Number assignment event types

State transitionEvent typeDescription
pending → failednumber_assignment_failedThe number was not assigned to the campaign.
failed → pendingnumber_assignment_pendingA failed assignment is being retried.
pending → completednumber_assignment_activatedThe number has been successfully assigned to the campaign.
postWebhooktenDlcStatusCallback

Payload

project_idstring required

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

event_atstring 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.

statestring required

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

brand_idstring required

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

campaign_idstring

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

number_assignment_order_idstring

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

number_assignment_idstring

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

phone_number_idstring

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

phone_numberstring

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

Response

Webhook received