For PureClarity to be able to send email it will need to first be configured. You will be required to add SPF/TXT, MX and CNAME records to your DNS. We recommend a technical user who is confident with DNS handle this.
Domain & Addresses
This page features 2 sections. The first section relates to the verification status of the domain specified by you. The second section allows the management of email addresses from which triggered emails will originate. It is recommended that a technical user who understands DNS settings handle the domain setup.
For PureClarity to send email on behalf of the client we are required to verify that you own the domain and have granted us permission to send email that appears to have originated from it. This section typically displays the current overall status of the domain verification and its subsections, along with a button to edit the settings related to it. If there has been a failure when verifying the domain then a retry button will be displayed. A failure indicates that the DNS settings for the domain have not been correctly updated.
If you have not yet configured the domain for us to use then a setup button will be displayed and no status information will be shown. Clicking the setup button will take you to the Manage Email Domain page.
This section of the page is used for the management of email addresses that will appear in the From field on a triggered email, in other words the email address of the sender. To begin adding email addresses you will have to setup the domain (see the previous section). Note that all email addresses will be relative to the chosen domain thus only the local-part of the email address can be edited.
To add an email address click the Add Email Address button. To edit an existing email address click the Edit button at the end of the row. Clicking the Delete button will display a confirmation dialog asking you to confirm the deletion.
When editing or adding an email address you will be able to specify the local-part of the email address. The local-part can be a maximum of 64 characters long. The domain part cannot be edited and must be managed via the Manage Email Domain page. Once done clicking the Confirm button will display a confirmation dialog asking you to confirm the changes. You can also click the Cancel button which will discard the changes if editing an email address or remove the row when adding a new email address.
Manage Email Domain
This page features 2 sections. The first section is a wizard that allows the input of the domain from which the triggered emails will appear to originate. The second section will display the status of verification alongside information required to complete the verification process. It is recommended that a technical user who understands DNS settings handle the domain setup.
PureClarity uses an email service provider (ESP). As with other email services there are verification checks that must be passed before emails can be sent. These verification steps ensure that we are verified to send emails on your behalf. It also helps to prevent emails been treated as spam by ISPs (Internet Service Providers).
This section of the page consists of a wizard to follow that allows you to configure which domain PureClarity should use as the origin point of the triggered emails. The steps are as follows (note that we use pureclarity.net as an example):
Step 1 – Domain Settings: This is where you specify the primary domain you wish PureClarity to use for verification. This can be either a root or subdomain. This is required to allow us to send emails on your behalf. This must be a domain which you own as you will need to add a TXT record that we will provide for verification.
Step 2 – MAIL FROM Settings: This is where you specify the MAIL FROM subdomain that PureClarity will use to achieve DMARC (Domain-based Message Authentication, Reporting and Conformance). This must be a subdomain of the primary domain provided for verification.
Step 3 – Validity Check: This step will check the information entered to ensure it matches the correct syntax for domains and subdomains. Once valid you can proceed to save this information. This will display a confirmation dialog asking you to confirm these changes. Note that changes can take up to 72 hours for us to verify, during which no emails can be sent.
Verification State and DNS Records
This section of the page displays the verification state and record information of the different pieces that contribute to full verification. This page will update itself with the latest information as the verification process occurs.
Domain: This shows the verification state of the primary domain you provided. It also contains a TXT record that you will need to add to the primary domain for verification to succeed.
MAIL FROM Subdomain: This shows the verification state of the MAIL FROM subdomain. This will also contain an MX record that you will need to add to the subdomain for verification to succeed. The MX record is provided once the primary domain is verified by us.
SPF: This contains a TXT record that you will need to add to your MAIL FROM subdomain. This is used to indicate which mail servers are authorised to send email on behalf of your domain.
DKIM: This shows the verification state of DKIM (DomainKeys Identified Mail) which ISPs (Internet Service Providers) treat as a signature to check that an email is legitimate and has not been modified in transit. It also contains 3 CNAME records that you will need to add to your DNS.
PureClarity will inform you via notifications in the admin when the verification process is complete.
Q: This seems like a lot to do. Is it really necessary?
A: The purpose of the verification checks is two fold. The first is that it is a requirement of many Email Service Providers. It allows PureClarity to verify that you have given us permission to send email on your behalf. The second is that it helps to cut down on ISPs flagging the emails as spam by allowing them to verify the legitimacy of the sender and check that the content has not been tampered with in transit. This can be a problem as ISPs will eventually blacklist senders who they flag as sending too much spam email.
Q: My domain still hasn’t verified. What’s going on?
A: Please ensure you have added the TXT record provided in the domain section to your domain. Once this is done we will be able to verify the domain.
Q: My verification state now shows as Failed. What do I do?
A: This is most commonly caused by an incorrect setup of the DNS records or by not adding the records within the 72 hour timeframe. If you’ve only just finished adding your records you can hit retry and the verification process will try again. The records will remain the same for each individual domain so you don’t need to worry about them changing when retrying. If you had already setup the records and verification is still failing please check the Manage Email Domain page to ensure you’ve placed the records against the correct domain.
Q: My emails are no longer sending. What’s happened?
A: As with any Email Service Provider there are limits in place as to how many emails can be bounced or flagged as spam. Should our ESP inform us of an issue we are required to take action to protect our clients ability to send email and the reputation of our service to prevent blacklisting. If our ESP contacts PureClarity informing us of an issue and we determine that it has arisen due to email you are sending then we will remove your ability to send email whilst a review is conducted. Other aspects of PureClarity will continue to work as normal.