Email configuration
This guide covers domain and email addresses verification
Last updated
This guide covers domain and email addresses verification
Last updated
To configure the Email platform, you have to
Choose the verified email address for the Email platform in the project.
Please note that platform configuration is project-specific. Configure the Email platform for each project you want to use for sending emails.
Verified emails and domains are available for all projects in your account.
In your Pushwoosh project, go to the Configure Platforms section and click Configure next to the Email platform:
When configuring the Email platform for the first time, you'll have to verify the email address you're going to send messages from.
Enter the sender's email address (From Email) and name (From Name). After that, press Continue.
If you want the reply email and name to differ from the sender's, you can also specify them in the Reply-to Email and Reply-to Name fields. If you leave the Reply-to Email field empty, the recipients will reply to the sender email. You can also 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.
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.
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:
Check out your DNS provider's instructions on adding CNAME records. For different providers, CNAME records may include or not include the domain name automatically.
If your DNS providers adds the domain name to your DNS records automatically, then you should enter only the the domain key part manually, e.g.:
Name: f25jambtewmknd5u3wxa5v75uxkf7jnx._domainkey
Type: CNAME
Value: f25jambtewmknd5u3wxa5v75uxkf7jnx.dkim.amazonses.com
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 |
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.
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.
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.
A TXT record is a type of DNS records providing additional text information about the domain.
If your domain already has an SPF record, then you must add the following SPF mechanism to the existing record.
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.
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.
To configure Email platform via the Pushwoosh API, submit the configureApplication request.
