# Manage Domains

Source: https://developer.nylas.com/docs/reference/api/manage-domains/

The Manage Domains endpoints let you register, verify, update, and delete email domains for use with [Transactional Send](/docs/v3/getting-started/transactional-send/) and [Nylas Agent Accounts](/docs/v3/agent-accounts/).

Before you can use these endpoints, you need a [Nylas Service Account](/docs/v3/auth/nylas-service-account/) to authenticate your requests. Nylas Service Account authentication uses cryptographic request signing with four custom headers (`X-Nylas-Kid`, `X-Nylas-Timestamp`, `X-Nylas-Nonce`, `X-Nylas-Signature`).

## Domain verification

After you register a domain, you must verify DNS records before you can use it. Call the **Get domain info** endpoint to retrieve the DNS records you need to configure, then call the **Verify domain** endpoint after you've added them to your DNS provider.

The verification types are:

| Type        | Required for                       | Description                              |
| ----------- | ---------------------------------- | ---------------------------------------- |
| `ownership` | All domains                        | Proves you control the domain.           |
| `dkim`      | Transactional Send, Agent Accounts | Authenticates outgoing mail.             |
| `spf`       | Transactional Send, Agent Accounts | Authorizes Nylas to send on your behalf. |
| `feedback`  | Transactional Send, Agent Accounts | Enables bounce reporting.                |
| `mx`        | Agent Accounts                     | Routes incoming mail to Nylas.           |

Nylas tracks `dmarc` and `arc` records but does not currently enforce or verify them. Setting up DMARC is highly recommended to prevent emails going to spam.

For more information, see [Managing domains](/docs/v3/email/domains/).


## Endpoints

- **GET** `/v3/admin/domains` - [List domains](https://developer.nylas.com/docs/reference/api/manage-domains/list-domains/)
- **POST** `/v3/admin/domains` - [Create domain](https://developer.nylas.com/docs/reference/api/manage-domains/create-domain/)
- **GET** `/v3/admin/domains/{domain_id}` - [Get domain](https://developer.nylas.com/docs/reference/api/manage-domains/get-domain/)
- **PUT** `/v3/admin/domains/{domain_id}` - [Update domain](https://developer.nylas.com/docs/reference/api/manage-domains/update-domain/)
- **DELETE** `/v3/admin/domains/{domain_id}` - [Delete domain](https://developer.nylas.com/docs/reference/api/manage-domains/delete-domain/)
- **POST** `/v3/admin/domains/{domain_id}/info` - [Get domain info](https://developer.nylas.com/docs/reference/api/manage-domains/get-domain-info/)
- **POST** `/v3/admin/domains/{domain_id}/verify` - [Verify domain](https://developer.nylas.com/docs/reference/api/manage-domains/verify-domain/)