> For an agent: the map of this documentation is at https://escouade.io/en/mail/docs/llms.txt; every page exists in Markdown, at the same address with `.md` appended.

# `add_domain`

Register your domain.

Registers the domain your space wants to send from (your own, or a subdomain such as agents.example.com) and returns the exact list of DNS records to publish at the domain's host: proof of ownership, two DKIM keys, SPF, MX, and DMARC as a recommendation. Nothing changes until verify_domain has found them. Once the domain is verified, you create inboxes on it that are no longer subject to the shared domain's limits. Registering a domain does not reserve it: it goes to the first space that publishes its proof of ownership. A public mail service (gmail.com…) or a domain whose ownership another space has already proven are refused.

## Access

- **Key**: an Escouade Mail key with `manage_inboxes`.
- **Space**: a verified space.
- **Changes nothing**: no, it acts.
- **Safe to replay**: yes.

## Parameters

| Parameter | Type | Required | Description |
|---|---|---|---|
| `domain` | string | yes | The domain name, for example example.com or agents.example.com. |

## Call it

```sh
curl -s https://api.subagent.fr/v1/add_domain \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer sak_…' \
  -d '{"domain": "…"}'
```

The full page in French, with the response fields and every refusal the tool can return: [/mail/docs/reference/add_domain](https://escouade.io/mail/docs/reference/add_domain).