The nShift Notifications API supports sending emails from customers' own email addresses. This guide explains how to configure and verify your email addresses for sending notifications using the From Email Addresses functionality.
Sections in this article:
- Overview
- Step 1 - Add your email
- Step 2 - Retrieve your DNS records
- Step 3 - Publish DNS record
- Step 4 - Verify the records
- Step 5 - Use your email address in templates
- Troubleshooting
Overview
It is necessary to configure three items in the From Email addresses functionality:
- Mail from address – the email address used to send notifications.
- Recipient address for bounce alerts – the email address that receives bounce alerts (when an email cannot be delivered).
- Recipient address for complaint alerts – the email address that receives complaint alerts (for spam or abuse reports).
Once configured, the functionality will generate the required DNS records (SPF and DKIM) that must be published with your DNS provider. After DNS verification, you’ll be able to use the configured email address in your notification templates.
Step 1 – Add your email
- Log in to nShift Portal and go to Settings > Services > From email addresses.
- Click Add new email address and enter the email addresses you wish to configure.
- Click Submit.
Note: The "Mail from address" must be a domain you own and can manage DNS for.
Step 2 – Retrieve your DNS records
After entering your email addresses, the functionality will generate two DNS records for your domain:
- SPF record – Authorizes our mail servers to send emails on behalf of your domain.
- DKIM record – Provides a cryptographic signature that validates your messages.
Example output (your values will differ):
SPF: v=spf1 include:mail.yourprovider.com ~all
DKIM (CNAME): selector1._domainkey.yourdomain.com → dkim.mail.yourprovider.com
Step 3 – Publish DNS records
- Log in to your DNS provider (e.g., GoDaddy, Cloudflare, Route53).
- Navigate to the DNS Management section.
- Add the records exactly as provided:
- For SPF: add MX and TXT records for your domain root (@).
- For DKIM: Add CNAME records
If your domain already has an SPF record, merge the new include with the existing one instead of replacing it.
Step 4 – Verify the records
Once you have published the DNS records, return to the From email addresses functionality.
The system will automatically check for DNS propagation.
When verification succeeds, the status will update to Verified.
Step 5 – Use your email address in templates
After the “From Address” is verified, you can:
- Go to Track > Notifications > Templates.
- Select your verified email address from the sender options.
This ensures all notifications will be sent from your trusted domain with full authentication (SPF + DKIM).
Troubleshooting
- DNS not verifying? It can take up to 24–48 hours for DNS changes to propagate.
- SPF already exists? Make sure you only have one SPF record; merge multiple entries into a single line.
- Still failing? Double-check for typos in hostnames or values, and confirm you saved the DNS records with the correct type (TXT or CNAME).