> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wazobiamail.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Sending domains

> Add, verify and manage the domains you send from.

# Sending domains

Every `from` address must belong to a verified domain on your account.

## 1. Add the domain

```bash theme={null}
curl -X POST https://app.wazobiamail.com/api/v1/sending/domains \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domain":"mail.example.com"}'
```

## 2. Publish the DNS records

```bash theme={null}
curl https://app.wazobiamail.com/api/v1/sending/domains/dom_abc123/dns-records \
  -H "X-API-Key: YOUR_API_KEY"
```

Add the returned SPF, DKIM and tracking records at your DNS provider.

## 3. Verify

```bash theme={null}
curl -X POST https://app.wazobiamail.com/api/v1/sending/domains/dom_abc123/verify \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" -d '{}'
```

## Cloudflare shortcut

If your DNS lives on Cloudflare, `GET /sending/domains/cloudflare/connect` returns an authorization URL. After approval, `POST /sending/domains/cloudflare/sync` publishes the records for you; `GET /sending/domains/cloudflare/status` shows the connection, and `DELETE /sending/domains/cloudflare/disconnect` removes it.

## Managing domains

List with `GET /sending/domains`, read one with `GET /sending/domains/{domain_id}`, rename with `PUT`, remove with `DELETE`. Removing a domain stops future sends from its addresses.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.