Email Configuration

This guide covers domain and email addresses verification

To configure the Email platform, you have to

Please note that platform configuration is app-specific. Configure Email platform for each app you want to use for sending emails.

Verified emails and domains are available for all apps in your account.

Email address verification

Select the app from the Applications section -> click on the platforms list -> press the Configure button next to the Email platform.

When configuring Email platform for the first time, you'll have to verify the email address you're going to send messages from.

Enter the email address and a sender name, and press Continue.

The Reply to field is optional. Leave it empty so that the recipients will reply to the sender email, or verify the additional Reply to email later.

We will send a verification email to the address you've entered. Please check the inbox and follow the instructions contained in the Sender Address Verification email. To complete the verification process, verify your domain.

Domain verification

ASCII

The domain name should not contain non-ASCII characters. In case it does, please encode the domain name with Punycode as described in RFC3492.

Once you’ve added the email address and completed its verification, you have to verify the domain. By verifying the domain, you ensure your emails will be sent and delivered as they supposed to be, and will not be filtered as spam.

Press the Settings button to see the authentication tokens.

DKIM authentication

DomainKeys Identified Mail (DKIM) is an email authentication method allowing the receiver to check that an email claimed to have come from a specific domain was indeed authorized by the owner of that domain.

DKIM tokens should be added to your domain’s DNS records as CNAME records. To pass the DKIM authentication, follow the steps below.

All the information about your domain is contained in a set of Domain Name System (DNS) records. A CNAME record is a type of resource record in the DNS which maps one domain name (an alias) to another (the Canonical Name).

  1. To see the DKIM authentication tokens, press the Settings button next to the domain status.

2. Copy tokens.

3. Sign in to your domain's account on DNS provider’s website.

To check whether that particular DNS provider serves the domain you’re verifying, use free Whois services.

4. Add the DKIM tokens as CNAME records to your domain’s DNS records.

Check out the Amazon guide on how to set up DKIM for a domain: https://docs.aws.amazon.com/ses/latest/DeveloperGuide/easy-dkim-setup-domain.html

A CNAME record should consist of Name and Value as follows:

Name

Type

Value

%token%._domainkey.%domain%

CNAME

%token%.dkim.amazonses.com

Check out your DNS provider’s instructions on adding CNAME records. For different providers, CNAME records may include or not include the domain itself.

Make sure you've added all three DKIM tokens to your DNS records.

If the CNAME records are published correctly, your domain’s status on the Domains list will change to "Verified".

The verification process usually takes from 5 to 10 minutes. In some cases, it might take up to 24 hours. If the domain's not verified after 24 hours, please do not hesitate to contact us.

SPF authentication

Sender Policy Framework (SPF) is an email validation standard, defined in RFC 7208, designed to combat email spoofing. SPF enables domain owners to specify which mail servers are authorized to send emails for their domain.

Adding a new SPF record

If your domain does not have an existing SPF record, publish a TXT record with the following value. The name of the record can be blank or @, depending on your DNS service.

"v=spf1 include:amazonses.com ~all"

A TXT record is a type of DNS records providing additional text information about the domain.

Adding to an existing SPF record

If your domain already has an SPF record, then you must add the following SPF mechanism to the existing record.

include:amazonses.com

You can check by yourself whether your domain's DNS records updated correctly by following the procedure described in the Amazon How to Check Domain Verification Settings guide.

Adding Emails

To add one more email address, enter it into the field left to the Add email button, then press the button. Verify the address by following the instructions in the verification email you'll receive.

If the domain of the address you've added is not verified yet, verify it by following the steps described above.

Configuring Emails via Pushwoosh API

To configure Email platform via the Pushwoosh API, submit the configureApplication request.