For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
  • FreeCustom.Email API
        • GETList inboxes
        • POSTRegister an inbox
          • DELUnregister an inbox
LogoLogo
FreeCustom.Email APIV1InboxesInbox

Unregister an inbox

||View as Markdown|
DELETE
https://api2.freecustom.email/v1/inboxes/:inbox
DELETE
/v1/inboxes/:inbox
$curl -X DELETE https://api2.freecustom.email/v1/inboxes/%7B%7Bmailbox%7D%7D \
>     -H "Authorization: Bearer <token>"
1{
2  "success": true,
3  "message": "string"
4}
Unregisters (deletes) a previously registered inbox from your account. All messages stored in the inbox are permanently deleted along with it. **Path parameters:** - `:inbox` — URL-encoded inbox address (e.g., `test%40domain.com`) **Behaviour:** - Returns `204 No Content` on success — no response body. - Returns `404` if the inbox does not exist or does not belong to your account. - All messages within the inbox are deleted immediately and irreversibly. **Plan:** All plans (Free and above).
Was this page helpful?
Previous

Register an inbox

Next

List messages

Built with

Unregisters (deletes) a previously registered inbox from your account. All messages stored in the inbox are permanently deleted along with it.

Path parameters:

  • :inbox — URL-encoded inbox address (e.g., test%40domain.com)

Behaviour:

  • Returns 204 No Content on success — no response body.
  • Returns 404 if the inbox does not exist or does not belong to your account.
  • All messages within the inbox are deleted immediately and irreversibly.

Plan: All plans (Free and above).

Authentication

AuthorizationBearer

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

Path parameters

inboxstringRequired

Response

OK
successboolean
messagestring

Errors

401
Unauthorized Error
404
Not Found Error
429
Too Many Requests Error