Delete a Message

Deletes a specific message for everyone in the chat (if permitted by WhatsApp).

Note: You can only delete messages that were sent by your own WhatsApp account, and within WhatsApp's allowed deletion timeframe (usually about 1 hour after sending).

---

Parameters

Name	Type	Required	Description
number	string	Yes	Recipient phone number in any format (digits only extracted internally).
message_id	string	Yes	ID of the message to be deleted. This ID is returned when the message was originally sent.

API Endpoint

POST https://app.rapiwa.com/api/delete-message

Header

Content-Type: application/json
Authorization: Bearer Your_Device_Key

Body

{
  "number": "88017XXXXXXXXX",
  "message_id": "XXXXXXXXXXXXXXXXXXXXX"
}

###Response:

{
  "success": true,
  "message_id": "XXXXXXXXXXXXXXXXXXX"
}

Code examples

bash

curl -X POST "https://app.rapiwa.com/api/delete-message" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer Your_Device_Key" \
  -d '{"number":"88017XXXXXXXXX","message_id":"XXXXXXXXXXXXXXXXXXXXX"}'

python

import requests
url = "https://app.rapiwa.com/api/delete-message"
headers = {"Content-Type": "application/json", "Authorization": "Bearer Your_Device_Key"}
payload = {"number": "88017XXXXXXXXX", "message_id": "XXXXXXXXXXXXXXXXXXXXX"}
requests.post(url, json=payload, headers=headers)

javascript

await fetch('https://app.rapiwa.com/api/delete-message', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json', 'Authorization': 'Bearer Your_Device_Key' },
  body: JSON.stringify({ number: '88017XXXXXXXXX', message_id: 'XXXXXXXXXXXXXXXXXXXXX' })
});

php

<?php
$data = ['number' => '88017XXXXXXXXX', 'message_id' => 'XXXXXXXXXXXXXXXXXXXXX'];
$options = ['http' => ['header' => "Content-Type: application/json\r\nAuthorization: Bearer Your_Device_Key\r\n", 'method' => 'POST', 'content' => json_encode($data)]];
file_get_contents('https://app.rapiwa.com/api/delete-message', false, stream_context_create($options));

ruby

require 'net/http'
require 'json'
uri = URI('https://app.rapiwa.com/api/delete-message')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request['Authorization'] = 'Bearer Your_Device_Key'
request.body = { number: '88017XXXXXXXXX', message_id: 'XXXXXXXXXXXXXXXXXXXXX' }.to_json
Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |h| h.request(request) }

go

payload := map[string]string{"number": "88017XXXXXXXXX", "message_id": "XXXXXXXXXXXXXXXXXXXXX"}
body, _ := json.Marshal(payload)
req, _ := http.NewRequest("POST", "https://app.rapiwa.com/api/delete-message", bytes.NewBuffer(body))
req.Header.Set("Content-Type", "application/json")
req.Header.Set("Authorization", "Bearer Your_Device_Key")
http.DefaultClient.Do(req)

csharp

var payload = new { number = "88017XXXXXXXXX", message_id = "XXXXXXXXXXXXXXXXXXXXX" };
var content = new StringContent(JsonSerializer.Serialize(payload), Encoding.UTF8, "application/json");
client.DefaultRequestHeaders.Add("Authorization", "Bearer Your_Device_Key");
await client.PostAsync("https://app.rapiwa.com/api/delete-message", content);

java

HttpRequest.newBuilder()
    .uri(URI.create("https://app.rapiwa.com/api/delete-message"))
    .header("Content-Type", "application/json")
    .header("Authorization", "Bearer Your_Device_Key")
    .method("POST", HttpRequest.BodyPublishers.ofString("{\"number\":\"88017XXXXXXXXX\",\"message_id\":\"XXXXXXXXXXXXXXXXXXXXX\"}"))
    .build();

swift

var request = URLRequest(url: URL(string: "https://app.rapiwa.com/api/delete-message")!)
request.httpMethod = "POST"
request.setValue("application/json", forHTTPHeaderField: "Content-Type")
request.setValue("Bearer Your_Device_Key", forHTTPHeaderField: "Authorization")
request.httpBody = try? JSONEncoder().encode(["number": "88017XXXXXXXXX", "message_id": "XXXXXXXXXXXXXXXXXXXXX"])
URLSession.shared.dataTask(with: request).resume()

powershell

$body = @{ number = "88017XXXXXXXXX"; message_id = "XXXXXXXXXXXXXXXXXXXXX" } | ConvertTo-Json
Invoke-RestMethod -Uri "https://app.rapiwa.com/api/delete-message" -Method Post -Headers @{"Content-Type"="application/json"; "Authorization"="Bearer Your_Device_Key"} -Body $body

typescript

await fetch('https://app.rapiwa.com/api/delete-message', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json', 'Authorization': 'Bearer Your_Device_Key' },
  body: JSON.stringify({ number: '88017XXXXXXXXX', message_id: 'XXXXXXXXXXXXXXXXXXXXX' })
});

rust

let payload = json!({"number": "88017XXXXXXXXX", "message_id": "XXXXXXXXXXXXXXXXXXXXX"});
client.post("https://app.rapiwa.com/api/delete-message").header("Authorization", "Bearer Your_Device_Key").json(&payload).send().await?;

💡 Tip: Keep your Device Key secure. Never share it publicly.

Contributors: Mannan Zinnat