Skip to main content
This guide is for users who already have a Mailchimp account and want to integrate it with OneSignal. If you don’t have a Mailchimp account, consider using OneSignal Email instead.

​
Requirements

​
Setup

​
1. Configure your domain for email

Go to the Mailchimp Transactional Email Domains page and add your domain if it hasn’t been added already.
After adding your domain:
  • Click View DKIM/SPF Setup Instructions to get your DNS records.
  • Optionally verify ownership via email under View details.
Update your DNS records with your DNS provider. Follow Mailchimp’s setup guide if needed. Mailchimp may take up to 48 hours to verify your domain. You’ll receive a confirmation email once complete.

​
2. Create API Key

In the Transactional Email Settings, click + New API Key.
You can name it something like OneSignal API Key.
Once created:
  • Copy the API key securely
  • Note your SMTP Username
Treat your API key like a password — keep it secure and never share it.
Enable the following permissions to ensure compatibility with OneSignal:

​
3. Enable email messaging in OneSignal

  1. In your OneSignal dashboard, go to Settings > Platforms > Email.
  1. Select Mailchimp as your provider and enter the API key and SMTP username.
  1. Set your default sender name and email address.

​
4. Send a test email

Go to OneSignal > Messages > Email and click New Email.
  • Add a subject line
  • Click Send Test Email
  • Enter your email address and click Send Test Message
You should receive your test email shortly.
Having issues? Check the Email FAQ or email [email protected].For faster assistance, include:
  • Your OneSignal App ID
  • Detailed issue description, logs, and screenshots
  • Steps to reproduce

​
Optional: Generate API key from Mailchimp Dashboard

If you are generating an API key from the main Mailchimp account dashboard:
  1. Click your avatar in the top-right corner.
  1. Go to Account & Billing.
  1. Click Extras > API Keys.
  1. Click Create A Key.
  1. Name your key and click Generate Key.
  1. Copy the API key securely.
✅ Email setup complete!Next steps: