> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Email setup

> Set up OneSignal Email by selecting a provider, creating a sender, configuring DNS authentication, and verifying your account.

Follow these steps to start sending authenticated emails with OneSignal. Dashboard configuration takes about 10–30 minutes.

<Frame caption="Email channel setup overview">
  <img src="https://mintcdn.com/onesignal/79QNOxxouFJHJ3s8/images/docs/email-setup-overview.jpg?fit=max&auto=format&n=79QNOxxouFJHJ3s8&q=85&s=58f7a05e17052da1bfffba5dc56d39bf" alt="Diagram showing the email setup steps: provider, sender, DNS, and verification" width="1280" height="720" data-path="images/docs/email-setup-overview.jpg" />
</Frame>

***

## Prerequisites

Before you start, make sure you have:

* A OneSignal account.
* A sender email address on a domain you own (e.g., `you@yourdomain.com`). Free mailbox providers like Gmail or Outlook are not supported as sending domains.
* Access to your domain's DNS settings, either directly or through someone on your team.

***

## Email setup steps

Follow each step to configure your email setup.

### Step 1: Select a provider

In your OneSignal dashboard, navigate to **Settings > Set up Email**.

To use OneSignal Email, click **Continue Setup**. To use a different provider, choose one from the **Optionally integrate with another email provider** section:

* [SendGrid](./sendgrid-setup)
* [Mailgun](./mailgun-setup)
* [Mailchimp Transactional](./mandrill-setup)

<Frame caption="Provider selection during email setup">
  <img src="https://mintcdn.com/onesignal/TrjGYudL1B3K9oZG/images/dashboard/email-configuration.png?fit=max&auto=format&n=TrjGYudL1B3K9oZG&q=85&s=a261b3a4691f6e0bac2451661e478a16" alt="Email configuration page showing provider options" width="1005" height="651" data-path="images/dashboard/email-configuration.png" />
</Frame>

### Step 2: Create a sender

Configure the default sender identity for OneSignal to send authenticated email from your domain:

* **Default sender email** — The *from* email address used when no other sender is specified (multiple senders are supported).
* **Default sender name** — The display name shown in the recipient's inbox (e.g., `Acme Team`).
* **Default reply-to** — The email address users reply to. You can override this per email.
* **Sending domain** — Auto-generated based on the sender email's domain. Click **Customize** to use a different subdomain for DNS authentication.

<Tip>
  For optimal deliverability, use a [subdomain](#what-is-a-subdomain-and-why-should-i-use-one) (e.g., `mail.yourdomain.com`) rather than your root domain.
</Tip>

<Frame caption="Default sender configuration">
  <img src="https://mintcdn.com/onesignal/TrjGYudL1B3K9oZG/images/dashboard/create-a-sender.png?fit=max&auto=format&n=TrjGYudL1B3K9oZG&q=85&s=7186eccad78ea5ebd4cc5bf8c7e8adef" alt="Form fields for default sender email, name, reply-to, and sending domain" width="1005" height="574" data-path="images/dashboard/create-a-sender.png" />
</Frame>

<Card title="Senders" icon="at" href="./senders">
  Add and manage multiple senders, from addresses, reply-to addresses, and sending domains.
</Card>

### Step 3: Configure DNS

Configure DNS records to authenticate your sending domain. If your registrar is supported, you can **Auto-Configure** or add the records manually.

<Frame caption="DNS configuration in the OneSignal dashboard">
  <img src="https://mintcdn.com/onesignal/TrjGYudL1B3K9oZG/images/dashboard/dns-manual-configure.png?fit=max&auto=format&n=TrjGYudL1B3K9oZG&q=85&s=826b4fdef6343099bc3063dbf0dc6667" alt="OneSignal dashboard showing required DNS records and their verification status" width="991" height="760" data-path="images/dashboard/dns-manual-configure.png" />
</Frame>

<Card title="Email DNS configuration" icon="globe" href="./email-dns-configuration">
  Step-by-step guide for auto-configuring or manually adding SPF, DKIM, and DMARC records.
</Card>

### Step 4: Verify your account

When finished with DNS configuration, click **Verify Account**.

OneSignal automatically reviews your domain health, sender reputation, blocklist status, and other deliverability signals to protect domain reputation and prevent abuse. Approval usually completes within a few minutes — you'll receive an email with the results.

<Frame caption="Verify Account in the OneSignal dashboard">
  <img src="https://mintcdn.com/onesignal/TrjGYudL1B3K9oZG/images/dashboard/account-verification.png?fit=max&auto=format&n=TrjGYudL1B3K9oZG&q=85&s=c764c8fcabfcd2d63c1be71ffd360183" alt="OneSignal dashboard prompt to verify your email account" width="991" height="678" data-path="images/dashboard/account-verification.png" />
</Frame>

<Check>
  If approved, you can start sending emails to your full audience immediately!
</Check>

<Danger>
  If denied, you can review the [Email domain configuration best practices](./email-domain-configuration-best-practices) for help and try again in a week.
</Danger>

***

## FAQ

### What is a subdomain and why should I use one?

A subdomain is a prefix added to your domain name — for example, `mail.yourdomain.com` is a subdomain of `yourdomain.com`. While your "From Address" can still appear as `anything@yourdomain.com`, the subdomain is used for email authentication and delivery.

<Frame caption="From domain vs. from address">
  <img src="https://mintcdn.com/onesignal/79QNOxxouFJHJ3s8/images/docs/email-from-domain-vs-from-address.png?fit=max&auto=format&n=79QNOxxouFJHJ3s8&q=85&s=85e09e6f75e20fc9f0a955c9be760d25" alt="Diagram showing the difference between the from domain and from address" width="2074" height="1374" data-path="images/docs/email-from-domain-vs-from-address.png" />
</Frame>

Using a subdomain isolates your email [sending reputation](./email-deliverability#reputation) from your root domain. If your marketing emails generate complaints, it won't affect your root domain's reputation for other services like corporate email. You can also maintain separate reputations for different mail streams:

* `mail.yourdomain.com` for marketing
* `receipts.yourdomain.com` for transactional

### How long does email setup take?

Dashboard configuration (Steps 1–4) typically takes 10–30 minutes. Assuming the account is approved, you can start sending emails to your full audience immediately!

### Can I send emails before I'm verified?

Before your account is approved, you can send test emails to your own email addresses. Sending to your full audience is enabled only after verification is complete.

### What if I don't have access to my DNS settings?

If your registrar is supported, you will see the option to **Auto-Configure** DNS records. If not, you will need someone with DNS access for your domain — typically a developer, IT admin, or whoever manages your domain registrar — to add the SPF, DKIM, and DMARC records manually. Share the exact values from the OneSignal dashboard with that person. Each record shows a check icon in the OneSignal dashboard once it's correctly configured.

### What DNS records are required?

OneSignal requires SPF, DKIM, and DMARC records to authenticate your sending domain. The exact values are shown in the OneSignal dashboard during setup. See [Email DNS configuration](./email-dns-configuration) for details.

### Can I use an external email provider instead of OneSignal Email?

Yes. OneSignal supports [SendGrid](./sendgrid-setup), [Mailgun](./mailgun-setup), and [Mandrill](./mandrill-setup) (Mailchimp Transactional) as external providers. Select your provider during the initial setup step. Features like multiple senders, suppression list management, and custom sending domains are only available with OneSignal Email.

### What happens if my DNS records don't match?

Emails sent from an unauthenticated domain are more likely to be rejected or filtered to spam by inbox providers. Verify your DNS records in the OneSignal dashboard — a warning icon indicates a mismatch that needs to be resolved.

***

## Related pages

<Columns cols={3}>
  <Card title="Import email list" icon="users" href="./import">
    Import your email list from a CSV file or API.
  </Card>

  <Card title="Email overview" icon="envelope" href="./email-messaging">
    Create and send your first email from the dashboard, Journeys, or the API.
  </Card>

  <Card title="Email reputation best practices" icon="shield-check" href="./email-reputation-best-practices">
    Protect your sender reputation with warm-up strategies, list hygiene, and deliverability monitoring.
  </Card>
</Columns>
