OneSignal's Email Messaging requires the use of a third-party email service provider to handle email delivery. All you have to do is set up the integration between the provider and OneSignal, and you'll be ready to send emails through OneSignal.
Mandrill is the transactional email service offered by Mailchimp. To set up Mandrill, you must first create a Mailchimp account if you do not already have one. Then, enable the Mailchimp Transactional Email Plan (first 500 sends are free).
Navigate to the Mandrill App <a href="https://mandrillapp.com/settings/sending-domains" target="_blank>Settings > Domains > Sending Domains and add your domain if you have not done so already.
When your domain is added, click View DKIM/SPF Setup Instructions, which provides the appropriate DNS settings you will need to update your domain. You can also verify your domain by clicking View details and receiving an email to your domain.
Next, you will need to update your DNS records for your domain host. Follow Mailchimp/Mandrill's instructions to learn more.
Once you have set up your DNS records, it make take up to 48 hours to work. Mailchimp will email you when your domain is verified.
In Mandrill, click Settings and + New API Key.
Optional: Name your API key something like
OneSignal API Key.
You will see your key was created successfully. Next, highlight the API key and copy it to your clipboard. Also note your SMTP Username here.
CAUTION! API Keys need to be secret
Your Mailchimp API Key is like a password. Keep it safe and do not share it.
In OneSignal, go to Settings > Platforms > Email
Select Mailchimp as the provider, and paste in the API key and SMTP Username.
Add a default name and email address that you want your emails to come from. These may be changed later on a per-message basis.
Select Upload CSV to Import Email Addresses. You can always do this again later.
If you have a website and want to prompt users to provide you email. Select Add Web Prompt to use OneSignal's Email Web Prompt.
You can now start sending emails. Go to Sending Email Messages.
To validate emails through your own backend server, you can enable Identity Verification in OneSignal dashboard Settings > Keys & IDs toggle on "Identity Verification for email + external_id (recommended)".
Read more on how to setup your backend for Identity Verification.
Since our API does a lot of communication between both platforms, you will likely need these permissions at the least:
Within Mandrill > Settings > Webhooks make sure you have a hooked into OneSignal's endpoint
https://onesignal.com/email/hooks/mandrill with the following settings:
Updated a day ago