Delete a message | freecustom-email

Permanently deletes a single message from the specified inbox by its message ID. **Path parameters:** - `:inbox` — URL-encoded inbox address (e.g., `test%40domain.com`) - `:id` — Message ID returned by `GET /v1/inboxes/:inbox/messages` **Behaviour:** - Returns `204 No Content` on success — no response body. - Returns `404` if the message or inbox does not exist. - Deletion is immediate and irreversible. **Plan:** All plans (Free and above).

Permanently deletes a single message from the specified inbox by its message ID.

Path parameters:

:inbox — URL-encoded inbox address (e.g., test%40domain.com)
:id — Message ID returned by GET /v1/inboxes/:inbox/messages

Behaviour:

Returns 204 No Content on success — no response body.
Returns 404 if the message or inbox does not exist.
Deletion is immediate and irreversible.

Plan: All plans (Free and above).

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

inboxstringRequired

idstringRequired

Response

successboolean

messagestring

Errors

401

Unauthorized Error

404

Not Found Error

429

Too Many Requests Error

Permanently deletes a single message from the specified inbox by its message ID.

Path parameters:

:inbox — URL-encoded inbox address (e.g., test%40domain.com)
:id — Message ID returned by GET /v1/inboxes/:inbox/messages

Behaviour:

Returns 204 No Content on success — no response body.
Returns 404 if the message or inbox does not exist.
Deletion is immediate and irreversible.

Plan: All plans (Free and above).

Bearer authentication of the form Bearer <token>, where token is your auth token.

$	curl -X DELETE https://api2.freecustom.email/v1/inboxes/%7B%7Bmailbox%7D%7D/messages/%7B%7BmessageId%7D%7D \
>	-H "Authorization: Bearer <token>"