> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developers.brevo.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.brevo.com/_mcp/server.

Domains authenticate and verify senders so recipients know the email comes from a genuine source. For endpoints to create and manage domains, see [API reference > Domains](/reference/create-domain).

## 1. Creating a new domain

Send a `POST` request to `https://api.brevo.com/v3/senders/domains` to create a new domain. Use the cURL request below:

```curl
curl --request POST \
     --url https://api.brevo.com/v3/senders/domains \
     --header 'accept: application/json' \
     --header 'api-key:' \
     --header 'content-type: application/json' \
     --data '
{
  "name": "mycompany.com"
}
'
```

Add your API key in the `api-key` header. This endpoint has one body parameter:

| Attribute | Datatype | Description                       | Value        |
| :-------- | :------- | :-------------------------------- | :----------- |
| `name`    | String   | Name of the domain being created. | mydomain.com |

\


**Response**

Sample success response:

```json
{
  "id": "641db448a6a7ea326e585e15",
  "domain_name": "mycompany.com",
  "message": "Domain added successfully. To authenticate it, add following DNS records",
  "dns_records": {
    "dkim_record": {
      "type": "TXT",
      "value": "k=rsa;p=MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDeMVIzrCa3T14JsNY0IRv5/2V1/v2itlviLQBwXsa7shBD6TrBkswsFUToPyMRWC9tbR/5ey0nRBH0ZVxp+lsmTxid2Y2z+FApQ6ra2VsXfbJP3HE6wAO0YTVEJt1TmeczhEd2Jiz/fcabIISgXEdSpTYJhb0ct0VJRxcg4c8c7wIDAQAB",
      "host_name": "mail._domainkey.",
      "status": false
    },
    "brevo_code": {
      "type": "TXT",
      "value": "brevo-code:4bc1566441c4131069853d135c5905ab",
      "host_name": "",
      "status": false
    }
  }
}
```

Sample bad request response:

```json
{
  "code": "invalid_parameter",
  "message": "Enter domain name in correct format. Example: myexampledomain.com"
}
```

Response codes:

| Response code | Message        | Description                                           |
| :------------ | :------------- | :---------------------------------------------------- |
| `200`         | Domain created | Returned when a domain is created.                    |
| `400`         | Bad request    | Returned when invalid or missing parameters are sent. |

\


## 2. Getting the list of your domains

Send a `GET` request to `https://api.brevo.com/v3/senders/domains` to retrieve the domains you've created. Use the cURL request below:

```curl
curl --request GET \
     --url https://api.brevo.com/v3/senders/domains \
     --header 'accept: application/json' \
     --header 'api-key: '
```

#### No attributes for getting the list of your domains

This endpoint takes no parameters. The request uses your API key to retrieve and return the domains you've created.

\


**Response**

The response returns all the domains you've created. Sample JSON:

```json
{
  "domains": [
    {
      "id": "641db6b43f10ae7b6604d178",
      "domain_name": "mycompany.com",
      "authenticated": false,
      "verified": false,
      "validationRequest": null,
      "verifier": null,
      "authenticator": null,
      "creator": {
        "id": "63930fe975f3bf52825956b7",
        "email": "obaidullah.khan@brevo.com",
        "method": null,
        "creationDate": "2023-03-24T14:41:56+00:00"
      },
      "ip": null
    }
  ],
  "count": 1,
  "current_page": 1,
  "total_pages": 1
}
```

Response codes:

| Response code | Message         | Description                                              |
| :------------ | :-------------- | :------------------------------------------------------- |
| `200`         | List of domains | Returns the list of domains.                             |
| `400`         | Bad request     | Returned for incorrect parameters or an invalid API key. |

\


## 3. Delete a domain

Send a `DELETE` request to `https://api.brevo.com/v3/senders/domains/{domainName}` to delete a domain. Insert the domain name in the endpoint URL as shown below:

```curl
curl --request DELETE \
     --url https://api.brevo.com/v3/senders/domains/mydomain.com \
     --header 'accept: application/json' \
     --header 'api-key: '
```

A `null` response indicates the domain was deleted. This endpoint takes only the `domainName` attribute:

| Attribute    | Datatype | Description        | Value         |
| :----------- | :------- | :----------------- | :------------ |
| `domainName` | String   | Name of the domain | mycompany.com |

**Response**

| Response code | Message               | Description                                |
| :------------ | :-------------------- | :----------------------------------------- |
| `200`         | Domain deleted        | Domain deleted.                            |
| `400`         | Bad request           | Invalid, incorrect, or missing parameters. |
| `404`         | Domain does not exist | Domain does not exist in the database.     |