Delete email messages by address

Permanently deletes every email in the authenticated account sent from or to the supplied address, including retained events whose parent message has expired. Events and durable recipients are deleted immediately with each message. The operation never searches or reports matches in another account. The legacy /v2/emails DELETE route is a backward-compatible alias.

DELETE /email_messages

JavaScript

JavaScript

import Telnyx from 'telnyx';

const client = new Telnyx({
  apiKey: process.env['TELNYX_API_KEY'], // This is the default and can be omitted
});

await client.emailMessages.deleteAll();

400

{
  "errors": [
    {
      "code": "10015",
      "title": "Bad Request",
      "detail": "email is required"
    }
  ]
}

Authorizations

Authorization · string · header · required

Telnyx API key supplied as Authorization: Bearer <token>. In production, auth may be validated by the API gateway and forwarded via Telnyx auth headers.

Query Parameters

address · string<email> · required

Sender or recipient address to delete. Matching is trimmed and case-insensitive.

Response

204

Matching account-scoped email data deleted successfully.