---
title: "Create domain"
method: POST
path: "/v3/admin/domains"
tags: ["Manage Domains"]
---

# Create domain

`POST /v3/admin/domains`

<div id="admonition-warning">⚠️ <b>Before you can use the Manage Domains endpoints, you need a <a href="/docs/v3/auth/nylas-service-account/">Nylas Service Account</a></b>.</div>

Registers a new email domain for your organization. After creating a domain, you must
[verify its DNS records](/docs/v3/email/domains/) before you can use it with Transactional Send or Nylas Agent Accounts.

## Request body

- object
  - `name` string, required — A human-readable label for the domain.
  - `domain_address` string, required — The domain address to register (for example, `mail.example.com`).

## Response `200`

OK

- object
  - `request_id` string — ID of the request.
  - `data` DomainObject
    - `id` string — Globally unique identifier for the domain.
    - `name` string — A human-readable label for the domain.
    - `branded` boolean — If `true`, this is a Nylas-branded `nylas.email` subdomain managed by Nylas. You can only have one free Nylas branded domain per organization and region. If `false`, this is a custom domain.
    - `domain_address` string — The domain address (for example, `mail.example.com`).
    - `organization_id` string — The ID of the Nylas organization that owns the domain.
    - `region` 'us' | 'eu' — The Nylas data center region where the domain is registered.
    - `verified_ownership` boolean — If `true`, the domain's ownership TXT record has been verified.
    - `verified_dkim` boolean — If `true`, the domain's DKIM TXT record has been verified.
    - `verified_spf` boolean — If `true`, the domain's SPF record has been verified.
    - `verified_mx` boolean — If `true`, the domain's MX record has been verified.
    - `verified_feedback` boolean — If `true`, the domain's feedback MX record for bounce detection has been verified.
    - `verified_dmarc` boolean — Currently not verified by Nylas. However, it is highly recommended to set DMARC to your desired value to prevent emails going to spam.
    - `verified_arc` boolean — Currently not verified by Nylas.
    - `created_at` number — When the domain was created, in seconds using the Unix timestamp format.
    - `updated_at` number — When the domain was last updated, in seconds using the Unix timestamp format.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `429` — Rate Limit

---

[API](https://skmtc.dev/nylas/apis/nylas-api.md) · [All operations](https://skmtc.dev/nylas/apis/nylas-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nylas/nylas-api/revisions/51c2c1b4ecff/schema)