Delete a message
DELETE/conversations/:conversation_id/messages/:message_id
Remove one message from a conversation.
There is no equivalent in the console — this is API-only, and it is genuinely destructive. It deletes our record of the message, not the copy the customer already received on WhatsApp, SMS or email. Use it to redact something that should never have been stored, not to "unsend".
The conversation's message count is corrected and attachments are detached from the Files Warehouse index. Every delete is written to the audit log with the credential that made it.
Request
Responses
- 200
- 401
- 403
- 404
Message deleted.
No token, an expired token, or a credential that has been revoked.
Response Headers
Correlation id for this request. Quote it when reporting a problem.
Refused. Either the credential does not hold the scope this endpoint needs (code: insufficient_scope), or the account's IP allow-list does not include the calling address (code: ip_not_allowed).
Response Headers
Correlation id for this request. Quote it when reporting a problem.
No such resource in this account.
Response Headers
Correlation id for this request. Quote it when reporting a problem.