Skip to navigation
API ReferenceVerified Domains

Verify domain

Verify a domain for sending.

Authentication

AuthorizationBearer

Authorization using a Mailchimp API key (a.k.a. Bearer token)

OR
AuthorizationBearer
Authorization using OAuth

Path parameters

domain_namestringRequired
The domain name.

Request

Submit a response to the verification challenge and verify a domain for sending.
codestringRequired
The code that was sent to the email address provided when adding a new domain to verify.

Response

The domain being verified for sending.
authenticatedbooleanOptionalRead-only
Whether domain authentication is enabled for this domain.
domainstringOptionalRead-only
The name of this domain.
is_free_email_providerbooleanOptionalRead-only

Returns whether the domain used is a public / free email provider. See Limitations of Free Email Addresses for more details.

statusenumOptionalRead-only
The Domain's current status.
verification_emailstringOptionalRead-only

The e-mail address receiving the two-factor challenge for this domain.

verification_sentdatetimeOptionalRead-only

The date/time that the two-factor challenge was sent to the verification email.

verifiedbooleanOptionalRead-only
Whether the domain has been verified for sending.