Skip to main content
Delete a message from your own chat history. Unlike revoke, this only removes the message from your view and does not affect the recipient’s chat.
This operation only deletes the message from your local chat history. The recipient will still see the message. To remove a message for everyone, use the Revoke Message endpoint instead.

Request

message_id
string
required
The unique identifier of the message to delete
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 deleted message
status
string
Status of the delete operation
curl -X POST \
  'https://your-api-domain.com/message/3EB0B430B6F8F1D0E053AC120E0A9E5C/delete' \
  -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 deleted successfully"
  }
}

Build docs developers (and LLMs) love