---
title: "Delete outbound SMTP email"
method: DELETE
path: "/v1/emails/{id}"
tags: ["Emails"]
---

# Delete outbound SMTP email

`DELETE /v1/emails/{id}`

## Request

- Base URL: `https://api.forwardemail.net`
- URL: `https://api.forwardemail.net/v1/emails/{id}`
- Auth: HTTP basic

Email deletion will set the status to `"rejected"` (and subsequently not process it in the queue) if and only if the current status is one of `"pending"`, `"queued"`, or `"deferred"`. This is useful for canceling emails scheduled via a future `date` before they are sent. We may purge emails automatically after 30 days after they were created and/or sent – therefore you should keep a copy of outbound SMTP emails in your client, database, or application.

**Authentication:** This endpoint supports both API token authentication and alias credentials authentication.

## Response `200`

Email deleted successfully

- object
  - `message` string

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found

---

[API](https://skmtc.dev/forwardemail/apis/forward-email-api.md) · [All operations](https://skmtc.dev/forwardemail/apis/forward-email-api/llms.txt) · [OpenAPI document](https://skmtc.dev/forwardemail/apis/forward-email-api/revisions/ecefab4527f6?raw)