Step-by-step guide to setting up Mailgun with OneSignal for sending email messages. Includes DNS verification, SMTP credential setup, API key generation, and OneSignal integration instructions.
This setup guide is if you have Mailgun already and want to integrate it with OneSignal. If you don’t have a Mailgun account, you can use OneSignal Email instead.
Skip this step if your domain is already set up in the US region.
Navigate to the Domains page
Open Add New Domain form
mail.yourdomain.com
) and ensure the region is US.Specify subdomain and select US region
Mailgun provides the following DNS records:
Update these in your DNS provider. Propagation may take up to 48 hours. Mailgun will notify you via email once verified.
To verify:
Verify DNS setup
If CNAME is not set correctly, email click, open, and unsubscribe tracking will not work.
Navigate to SMTP Credentials
Add new SMTP credentials
Create SMTP user
Copy SMTP password
Navigate to API Keys
Add new key
Create key
Copy API key
App setup email
App setup email
Configure provider
from
email address.Configure additional settings
Navigate to Mailgun > Sending > Webhooks > Your Domain > Webhooks and add:
Add webhook
Ensure recipients are directed to secure URLs.
Change tracking protocol
Send test email
You should receive the test email shortly.
See our Email FAQ
Need help?
Chat with our Support team or email support@onesignal.com
Please include:
We’re happy to help!
Email setup complete! Next steps:
Step-by-step guide to setting up Mailgun with OneSignal for sending email messages. Includes DNS verification, SMTP credential setup, API key generation, and OneSignal integration instructions.
This setup guide is if you have Mailgun already and want to integrate it with OneSignal. If you don’t have a Mailgun account, you can use OneSignal Email instead.
Skip this step if your domain is already set up in the US region.
Navigate to the Domains page
Open Add New Domain form
mail.yourdomain.com
) and ensure the region is US.Specify subdomain and select US region
Mailgun provides the following DNS records:
Update these in your DNS provider. Propagation may take up to 48 hours. Mailgun will notify you via email once verified.
To verify:
Verify DNS setup
If CNAME is not set correctly, email click, open, and unsubscribe tracking will not work.
Navigate to SMTP Credentials
Add new SMTP credentials
Create SMTP user
Copy SMTP password
Navigate to API Keys
Add new key
Create key
Copy API key
App setup email
App setup email
Configure provider
from
email address.Configure additional settings
Navigate to Mailgun > Sending > Webhooks > Your Domain > Webhooks and add:
Add webhook
Ensure recipients are directed to secure URLs.
Change tracking protocol
Send test email
You should receive the test email shortly.
See our Email FAQ
Need help?
Chat with our Support team or email support@onesignal.com
Please include:
We’re happy to help!
Email setup complete! Next steps: