---
title: "Add domain to account"
method: POST
path: "/3.0/verified-domains"
tags: ["verified-domains"]
---

# Add domain to account

`POST /3.0/verified-domains`

## Request

- Base URL: `https://api.mailchimp.com`
- URL: `https://api.mailchimp.com/3.0/verified-domains`
- Auth: one of:
  - HTTP bearer
  - OAuth 2
    - Authorization code: `https://login.mailchimp.com/oauth2/authorize`
    - Token URL: `https://login.mailchimp.com/oauth2/token`
- TypeScript: <https://skmtc.dev/mailchimp/apis/mailchimp-api/docs/3.0/verified-domains/post.ts> (a function with typed inputs; its response is checked against the schema)

Add a domain to the account.

## Request body

- object: The verified domains currently on the account.
  - `verification_email` string, required: The e-mail address at the domain you want to verify. This will receive a two-factor challenge to be used in the verify action.

## Response `200`

The newly-created domain.

- object: The verified domains currently on the account.
  - `authenticated` boolean: Whether domain authentication is enabled for this domain.
  - `domain` string: The name of this domain.
  - `is_free_email_provider` boolean: Returns whether the domain used is a public / free email provider. See [Limitations of Free Email Addresses](https://mailchimp.com/help/limitations-of-free-email-addresses/) for more details.
  - `status` 'VERIFICATION_IN_PROGRESS' | 'VERIFIED' | 'EXPIRED' | 'ERROR' | 'AUTHENTICATION_IN_PROGRESS' | 'AUTHENTICATION_ERROR' | 'AUTHENTICATED': The Domain's current status.
  - `verification_email` string: The e-mail address receiving the two-factor challenge for this domain.
  - `verification_sent` string, date-time: The date/time that the two-factor challenge was sent to the verification email.
  - `verified` boolean: Whether the domain has been verified for sending.

## Other responses

- `default`: An error generated by the Mailchimp API.

---

[API](https://skmtc.dev/mailchimp/apis/mailchimp-api.md) - [All operations](https://skmtc.dev/mailchimp/apis/mailchimp-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mailchimp/apis/mailchimp-api/revisions/53bf4b156855?raw)