Deleting messages, message media or message bodies

You can delete individual records of messages or media associated with messages by using the HTTP DELETE functionality of the API.

  • To delete individual message records through the API, make an HTTP DELETE request to the message resource. This will also delete any media objects associated with that message, assuming those exact same media are not also associated with another message on your account.
  • To delete individual media files associated with MMS messages through the API, make an HTTP DELETE request to the message media resource.

Notice: As of October 14, 2020, deleting the record of a message automatically deletes the media associated with the message as well (if applicable).

Delete message bodies

If you want to remove only the message's body (and keep the actual record of the message), you make an HTTP POST request to the message resource to update the body with an empty string "". For more details, see Update a Message resource (Twilio Docs)

An even better option would be to use Message Redaction, which allows you to redact the phone number and body of a message before it's stored. Users can request access and full details by filling out this form.

Have more questions? Submit a request
Powered by Zendesk