Skip to main content
Revoke (delete for everyone) a message that you have sent. This will remove the message from both your chat and the recipient’s chat.
This operation only works for messages you have sent. You cannot revoke messages sent by others.

Request

message_id
string
required
The unique identifier of the message to revoke
X-Device-Id
string
Device identifier for multi-device support. Required when multiple devices are registered. If only one device is registered, it will be used as the default.
phone
string
required
Phone number with country code and WhatsApp suffixExample: [email protected]

Response

code
string
Response code (e.g., SUCCESS)
message
string
Response message describing the result
results
object
message_id
string
The ID of the revoked message
status
string
Status of the revoke operation
curl -X POST \
  'https://your-api-domain.com/message/3EB0B430B6F8F1D0E053AC120E0A9E5C/revoke' \
  -H 'Content-Type: application/json' \
  -H 'X-Device-Id: my-device' \
  -u 'username:password' \
  -d '{
    "phone": "[email protected]"
  }'
{
  "code": "SUCCESS",
  "message": "Success",
  "results": {
    "message_id": "3EB0B430B6F8F1D0E053AC120E0A9E5C",
    "status": "Message revoked successfully"
  }
}

Build docs developers (and LLMs) love