Unlinks the device on the phone (unless provider_session_revoke=false; a number not connected right now is not unlinked there, WhatsApp drops an idle linked device after 30 days), erases its login and its stored chats, messages and contacts, and sends AccountStatus DELETED. 503 whatsapp-connecting for a moment during an update of Swarmhit: retry.
Your API key from the console (gw_live_…).
In: header
Path Parameters
A WhatsApp account id (wa_…).
^wa_[A-Za-z0-9_-]{8,64}$Query Parameters
true (default) also unlinks the device from the phone's Linked devices; false only deletes the number here and leaves the device listed on the phone.
"true"Value in
- "true"
- "false"
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X DELETE "https://example.com/whatsapp/api/v1/accounts/wa_Xk2pQ9rT4vW8yZ1a"{ "object": "AccountDeleted"}Simulate WhatsApp on a sandbox number POST
Sandbox only (a `gw_test_` key, a sandbox number): what a person does to the number, arriving as WhatsApp's own would, so your sandbox webhook gets the same event as live. A live number answers 403. | `kind` | What happens | |---|---| | `message_received` (default) | `from` writes to the number. | | `message_reaction` | `from` reacts (`reaction`, an emoji) to the number's message (`message_id`, else its newest to them). | | `message_read` | `from` reads the number's message (told once per message). | | `message_edited` | `from` edits their message (`message_id`, else their newest) to `text`. | | `message_deleted` | `from` deletes their message for everyone. | `message_delivered` follows each message the number sends by itself, a moment later. Reads follow too: `GET /messages` shows the reaction, the read, the edit or the deletion.
Get a WhatsApp number GET
Next Page