OneSignal Help & Documentation

Welcome to the OneSignal New IA developer hub. You'll find comprehensive guides and documentation to help you start working with OneSignal New IA as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    Discussions

Mandrill Setup

How to setup Mandrill for use in OneSignal Email Messaging

Beta Feature

OneSignal 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.

Step 1. Create Mailchimp account, and add Mandrill

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, add Mandrill to your account. You must have purchased Email Blocks in the Monthly Transactional Email Plan section prior to using Mandrill for email.

Step 2. Configure your domain for email

Next, you will need to set up your domain so that it can send emails from Mandrill. Go to Settings -> Domains, enter in your domain, and click 'Add':

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. You can follow Mandrill's instructions to learn more.

Once you have set up your DNS records, it make take up to 48 hours to work. Mailgun will email you when your domain is verified.

FAQ

How do I change my domain's email settings?

Step 3. Create API Key

Next, in Mandrill go to Settings and click 'New API Key'.

Next, name your API key something like OneSignal API Key, and click 'Create API Key' when you are ready.

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.

🚧

Your Mailchimp API Key is like a password. Keep it safe and do not share it.

Step 3. Enable Email Messaging

Go to Settings > Platforms and scroll down until you see Email and click on it.

Next, you must configure your email settings. Select Mandrill as the provider, and paste in the API key and SMTP User you just copied in Step 2.

Delivery Defaults

Add the name and email address that you want your emails to come from (you may override these when sending a message from New Email)

Identity Verification

Recommended

By default, Identity Verification is disabled, however we recommend using it. You can enable Identity Verification here if you can support it.

👍

You're done! You can now start sending emails. Go to Sending Email Messages.

Updated 2 years ago


Mandrill Setup


How to setup Mandrill for use in OneSignal Email Messaging

Beta Feature

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.