---
title: Delete a domain
openapi: /openapi/mailfully.yaml DELETE /v1/domains/{id}
---

> **For AI agents:** the complete documentation index is at [llms.txt](https://mailfully.com/docs/llms.txt). Append `.md` to any page URL for its markdown version.

`DELETE https://api.mailfully.com/v1/domains/{id}`

Deletes a sending domain. On success it returns `204 No Content` with an empty body. Any key with the `send` scope can delete, test or live. Mail still queued or scheduled from the domain fails after it is deleted. Requires the `send` scope.

## Authentication

- `apiKey` — http bearer

## Path parameters

- `id` (string, required) — The domain id (`dom_…`).

## Response 204

The domain was deleted. The response has no body.

## Response 401

Authentication failed.
  - response (object)
    - `error` (object, required)
      - `type` (string, required) — Machine-readable error code.
      - `message` (string, required) — Human-readable error message.
      - `param` (string) — The offending field; present only on validation errors.

## Response 403

The credential is valid but not permitted.
  - response (object)
    - `error` (object, required)
      - `type` (string, required) — Machine-readable error code.
      - `message` (string, required) — Human-readable error message.
      - `param` (string) — The offending field; present only on validation errors.

## Response 404

The requested resource was not found.
  - response (object)
    - `error` (object, required)
      - `type` (string, required) — Machine-readable error code.
      - `message` (string, required) — Human-readable error message.
      - `param` (string) — The offending field; present only on validation errors.

## Response 409

An API key is tied to this domain.
  - response (object)
    - `error` (object, required)
      - `type` (string, required) — Machine-readable error code.
      - `message` (string, required) — Human-readable error message.
      - `param` (string) — The offending field; present only on validation errors.

## Response 429

Adding and deleting domains share a limit of 10 a minute per environment.
  - response (object)
    - `error` (object, required)
      - `type` (string, required) — Machine-readable error code.
      - `message` (string, required) — Human-readable error message.
      - `param` (string) — The offending field; present only on validation errors.

## Response 500

An unexpected error occurred.
  - response (object)
    - `error` (object, required)
      - `type` (string, required) — Machine-readable error code.
      - `message` (string, required) — Human-readable error message.
      - `param` (string) — The offending field; present only on validation errors.

## Response 503

The service is temporarily unavailable.
  - response (object)
    - `error` (object, required)
      - `type` (string, required) — Machine-readable error code.
      - `message` (string, required) — Human-readable error message.
      - `param` (string) — The offending field; present only on validation errors.


---

📦 **OpenAPI specs:** Every OpenAPI specification referenced by this documentation is available as a single download — https://mailfully.com/docs/api-specs.zip