---
title: "Verify domain"
method: POST
path: "/3.0/verified-domains/{domain_name}/actions/verify"
tags: ["verified-domains"]
---

# Verify domain

`POST /3.0/verified-domains/{domain_name}/actions/verify`

## Request

- Base URL: `https://api.mailchimp.com`
- URL: `https://api.mailchimp.com/3.0/verified-domains/{domain_name}/actions/verify`
- 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/:domain_name/actions/verify/post.ts> (a function with typed inputs; its response is checked against the schema)

Verify a domain for sending.

## Path parameters

- `domain_name` string, required

## Request body

- object: Submit a response to the verification challenge and verify a domain for sending.
  - `code` string, required: The code that was sent to the email address provided when adding a new domain to verify.

## Response `200`

The domain being verified for sending.

- 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)