Whatsapp waba added

Reports the outcome of a WhatsApp Embedded Signup session. Telnyx sends it to the webhook_url set with PATCH /v2/whatsapp/user_data when the session succeeds or fails.

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.

WEBHOOK whatsappWabaAdded

Example

{
  "data": {
    "record_type": "event",
    "id": "5d4f8c1a-6b2e-4f3a-9c7d-2e1b0a9f8e7d",
    "event_type": "whatsapp.waba_added",
    "occurred_at": "2026-10-01T10:02:11.000Z",
    "payload": {
      "record_type": "waba_account_added",
      "waba_id": "123456789012345",
      "phone_numbers": [
        "[phone]"
      ],
      "status": "SUCCESS",
      "event_id": "019f4253-e09a-7622-bc6f-625378711d78"
    }
  }
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

telnyx-timestamp · integer<int64> · required

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

telnyx-signature-ed25519 · string · required

Base64 encoded Ed25519 signature for webhook verification - compatible with webhook-signature Ed25519 signature of timestamp|payload for verification

Body

application/json

data · object · required

Show child attributes

Response

200

Return an HTTP 200 to acknowledge the webhook.