---
title: "WhatsApp WABA Added"
method: POST
path: "whatsappWabaAdded"
tags: ["Callbacks"]
---

# WhatsApp WABA Added

`POST whatsappWabaAdded` (webhook)

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.

## Headers

- `telnyx-timestamp` integer, required: Unix timestamp for replay attack prevention
- `telnyx-signature-ed25519` string, required: Ed25519 signature of timestamp|payload for verification

## Payload

- WhatsappWabaAddedEvent
  - `data` WhatsappWabaAdded, required
    - `record_type` 'event', required
    - `id` string, uuid, required
    - `event_type` 'whatsapp.waba_added', required
    - `occurred_at` string, date-time, required
    - `payload` WhatsappWabaAddedPayload, required
      - `record_type` 'waba_account_added', required
      - `waba_id` string, required: Meta WhatsApp Business Account identifier.
      - `phone_numbers` string[]: Phone numbers found on the WABA. Omitted for standard sessions started with a phone_number_id, and for sessions that fail before Telnyx fetches the numbers.
      - `status` 'SUCCESS' | 'FAILURE', required: Signup session outcome.
      - `event_id` string, required: Signup session ID.
      - `errors` string[]: Errors recorded during provisioning.

## Acknowledgement `200`

Return an HTTP 200 to acknowledge the webhook.

---

[API](https://skmtc.dev/team-telnyx/apis/telnyx-api-2.md) - [All operations](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/llms.txt) - [OpenAPI document](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/revisions/f82938f53ff4?raw)