Create a new sender domain

POST

https://api.brevo.com/v3/senders/domains

POST

/v3/senders/domains

import { BrevoClient } from "@getbrevo/brevo";
async function main() {
    const client = new BrevoClient({
        apiKey: "YOUR_API_KEY_HERE",
    });
    await client.domains.createDomain({
        name: "mycompany.com",
    });
}
main();

{
  "id": 5,
  "domain_name": "mycompany.com",
  "message": "Domain added successfully. To authenticate it, add following DNS records",
  "domain_provider": "Cloudflare",
  "dns_records": {
    "brevo_code": {
      "host_name": "@",
      "type": "TXT",
      "value": "brevo-code=abc123def456",
      "status": false
    },
    "dkim_record": {
      "host_name": "mail._domainkey",
      "type": "TXT",
      "value": "v=DKIM1; k=rsa; p=MIGfMA0GCSqGSIb3DQEBAQUAA4GN...",
      "status": false
    },
    "dmarc_record": {
      "host_name": "_dmarc",
      "type": "TXT",
      "value": "v=DMARC1; p=none; rua=mailto:dmarc@mycompany.com",
      "status": false
    }
  }
}

Creates a new domain in Brevo.

Use this to:

Add new domains for sending emails
Set up domain authentication for better deliverability
Configure DNS records for email authentication
Establish domain-based sender identities

Key information returned:

Created domain ID and configuration
Required DNS records for authentication
Domain provider detection results
Setup instructions and next steps

Authentication

api-keystring

The API key should be passed in the request headers as api-key for authentication.

AuthorizationBearer

OAuth 2.0 client_credentials (machine-to-machine) grant. Exchange your app’s client_id/client_secret for a short-lived Bearer token.

Request

Domain configuration

namestringRequiredformat: "hostname"

Domain name to be added

Response

Domain created successfully

idlong

ID of the Domain created

domain_namestring

Domain name

messagestring

Success message with next steps

domain_providerstringOptional

Detected domain provider

dns_recordsobjectOptional

DNS records required for domain authentication

Errors

400

Bad Request Error