---
title: "WhatsApp Account Update"
method: POST
path: "whatsappAccountUpdate"
tags: ["Callbacks"]
---

# WhatsApp Account Update

`POST whatsappAccountUpdate` (webhook)

Reports coexistence lifecycle changes for a WhatsApp Business Account.

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

- WhatsappAccountUpdateEvent
  - `data` WhatsappAccountUpdate, required
    - `record_type` 'event', required
    - `id` string, uuid, required
    - `event_type` 'whatsapp.account.update', required
    - `occurred_at` string, date-time, required
    - `payload` WhatsappAccountUpdatePayload, required
      - `record_type` 'whatsapp_account', required
      - `waba_id` string, required — Meta WhatsApp Business Account identifier.
      - `event` string, required — Account event reported by Meta. Coexistence lifecycle values include `ACCOUNT_OFFBOARDED`, `ACCOUNT_RECONNECTED`, and `PARTNER_REMOVED`. Preserve unknown values for forward compatibility.

## 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/227c33b1ac9c?raw)