Platform 2 Guide — This article applies to the new platform. Looking for classic platform docs? Browse the Platform 1 collection.
Why: Customize your email sender name and address to enhance your branding and improve email deliverability. This ensures your members recognize your app's communications and trust the messages they receive.
Navigate: App Station > App Settings > Email Sender
Quick Start
Click App Settings in the left navigation menu.
Select Email Sender.
Enter your desired Sender Email Address and Sender Display Name.
Click Create Sender to register the email.
Follow the confirmation email instructions to verify your sender address.
Detailed Steps
1. Access Email Sender Settings
To configure your email sender, start by navigating to the Email Sender settings in your App Station.
Go to App Station in the left navigation.
Click on App Settings.
Select Email Sender.
2. Enter Sender Details
In the Email Sender settings, you will need to provide the following information:
Sender Email Address: This is the email address from which notifications will be sent (e.g.,
[email protected]).Sender Display Name: This is the name that will appear in the "From" field of the emails (e.g., "Mary's Kitchen").
After entering the details, click Create Sender to register the email with the email service.
3. Confirm Email Ownership
Once you click Create Sender, a confirmation email will be sent to the email address you provided. The email owner must:
Open the confirmation email.
Click the confirmation link inside the email.
The status will change from "Pending" to "Confirmed" once this step is completed.
Note: If the email address belongs to someone else, coordinate with them to ensure they click the confirmation link.
4. Add DNS Records
After confirming your email, you will need to add two DNS records to your domain settings:
DKIM Record (Required)
Type: TXT
Host:
20231001._domainkey.yourdomain.comValue:
v=DKIM1; k=rsa; p=MIGfMA0GCSqGSIb3...
Return-Path Record (Required)
Type: CNAME
Host:
pm-bounces-mkValue:
pm.mtasv.net
5. Wait for DNS Propagation
After adding the DNS records, it may take 15 minutes to 48 hours for the changes to propagate. During this time, the status will show as "Pending," and emails will revert to the default sender.
6. Verify DNS Records
Once you believe the DNS changes have propagated, click Check Verification Status in the Email Sender settings to verify that your DNS records are correctly set up.
You will see the following statuses:
Email Confirmed: ✓
DKIM Verified: ✓
Return-Path Verified: ✓
Status: VERIFIED
Note: All three requirements (email confirmation, DKIM, and Return-Path) must be completed for the custom sender to become active.
How It Works
Until your custom sender is fully verified, notification emails will be sent from the platform's default email address. You can configure a Reply-To address on the Email Sender page, which will be used until verification is complete. After verification, replies will go directly to your verified sender address.
Troubleshooting
If you encounter issues:
DNS Not Verifying: Wait longer (up to 48 hours) and ensure the exact values were copied without extra spaces.
Email Still Shows Default Sender: Verify that email confirmation, DKIM, and Return-Path are all complete.
Can't Create Multiple Senders: Each app can only have one active sender signature. To change it, delete the existing sender and create a new one.
