Skip to navigation
API ReferenceVerified Domains

Add domain to account

Add a domain to the account.

Authentication

AuthorizationBearer

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

OR
AuthorizationBearer
Authorization using OAuth

Request

The verified domains currently on the account.
verification_emailstringRequired

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

The newly-created domain.

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.