Disconnect a WhatsApp account

DELETE 
/account/wabas/:wabaId

We get out of the way: we unsubscribe the webhooks and delete what only existed here (token, numbers, template mirror).

We do not deregister the number at Meta — the account stays yours, and a /deregister would break the number for any provider.

Request

Responses

200

Record found.

401

Missing, malformed, unknown or revoked token (authentication), or a suspended account (tenant_inactive).

404

Resource does not exist (not_found).

422

Payload failed validation (invalid_request, detailed in issues) or was rejected by Meta (meta_error, with the original body in meta).

429

Rate limit exceeded (rate_limit).

Response Headers

Retry-After

Seconds to wait before retrying.

X-RateLimit-Category

Which rate limit category applied — send, media or default.

X-RateLimit-Scope

Which bucket the other headers describe — key (the API key), session (the dashboard) or account (the account ceiling).

X-RateLimit-Limit

Request ceiling for this category in the current window.

X-RateLimit-Remaining

Requests left in the current window.