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.
{
"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": [
"+15551234567"
],
"status": "SUCCESS",
"event_id": "019f4253-e09a-7622-bc6f-625378711d78"
}
}
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
Unix timestamp (seconds since epoch) of when the webhook was sent - compatible with webhook-timestamp Unix timestamp for replay attack prevention
Base64 encoded Ed25519 signature for webhook verification - compatible with webhook-signature Ed25519 signature of timestamp|payload for verification
Body
Show child attributes
Show child attributes
Response
Return an HTTP 200 to acknowledge the webhook.
Was this page helpful?
{
"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": [
"+15551234567"
],
"status": "SUCCESS",
"event_id": "019f4253-e09a-7622-bc6f-625378711d78"
}
}
}