Sign in

v52

OpenAPI 3.1.0raw.githubusercontent.com2026-07-311,1941,9384.1 MB
Callbacks

Campaign Status Update

This webhook uses Telnyx headers (telnyx-timestamp, telnyx-signature-ed25519) that are compatible with Standard Webhooks specification for SDK generation. Custom validation logic can map these to standard webhook-timestamp and webhook-signature equivalents. See https://github.com/standard-webhooks/standard-webhooks for details.

postWebhookcampaignStatusUpdate

Headers

telnyx-timestampinteger required

Unix timestamp for replay attack prevention

Unix timestamp (seconds since epoch) of when the webhook was sent - compatible with webhook-timestamp

telnyx-signature-ed25519string required

Ed25519 signature of timestamp|payload for verification

Base64 encoded Ed25519 signature for webhook verification - compatible with webhook-signature

Payload

brandIdstring

Brand ID associated with the campaign.

campaignIdstring

The ID of the campaign.

createDatestring

Unix timestamp when campaign was created.

cspIdstring

Alphanumeric identifier of the CSP associated with this campaign.

descriptionstring

Description of the event.

isTMobileRegisteredboolean

Indicates whether the campaign is registered with T-Mobile.

status'ACCEPTED' | 'REJECTED' | 'DORMANT' | 'success' | 'failed'

The status of the campaign.

type'TELNYX_EVENT' | 'REGISTRATION' | 'MNO_REVIEW' | 'TELNYX_REVIEW' | 'NUMBER_POOL_PROVISIONED' | 'NUMBER_POOL_DEPROVISIONED' | 'TCR_EVENT' | 'VERIFIED'

Example payload

{
  "brandId": "d88dd2aa-1bb9-4ef0-9ec8-1752b80316a5",
  "campaignId": "4b300178-131c-d902-d54e-72d90ba1620j",
  "description": "Campaign has been marked as dormant",
  "status": "DORMANT",
  "type": "TELNYX_EVENT"
}

Response

The server must return a HTTP 200, otherwise we will reattempt to deliver the webhook to the failover URL.