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

# Hercules Email

> Send emails from your app. Verify email or domain. Welcome emails, invoices, order confirmations, and more.

Send emails to your users directly from inside your Hercules app. Send emails from a free Hercules email or from your own branded email address.

<div className="screenshot ocean">
  <img src="https://mintcdn.com/zeus-0f6dadbf/_h8yJmXegD6Hz1Ps/images/apps/email-verify.png?fit=max&auto=format&n=_h8yJmXegD6Hz1Ps&q=85&s=3a2459c4a2af95e8eb89067eff393e6f" alt="Hercules Emails overview showing sent emails and delivery stats" width="2472" height="1452" data-path="images/apps/email-verify.png" />
</div>

### How do I get started?

1. Go to the **Emails** tab
2. Verify a single **email** or an entire **domain**
3. That's it!

Now just tell Hercules when you want to send an email

```text Email sending examples wrap theme={}
Send a welcome email to every user when they sign up
```

### What are common use cases for sending emails from within my app?

* Welcome emails when a new user signs up
* Form submissions
* Invoices for a purchase
* Order confirmations after a purchase
* Account alerts like login from a new device

### How do I send emails to all my users?

Go to the horizontal Send email tab

<div className="screenshot ocean">
  <img src="https://mintcdn.com/zeus-0f6dadbf/njQwrBJO_N9LDXl3/images/apps/email-send.png?fit=max&auto=format&n=njQwrBJO_N9LDXl3&q=85&s=3421bc5b168d431e6cf43dfb02a806e7" alt="Send email tab with recipient selection and compose options" width="2216" height="1344" data-path="images/apps/email-send.png" />
</div>

## FAQ

<AccordionGroup>
  <Accordion title="How do I verify my email address?">
    1. Go to the **Emails** tab
    2. Input the email address you want to send from.
    3. Click the verification link we send to that email

    Once verified, Hercules will be able to send emails from that email address
  </Accordion>

  <Accordion title="How do I verify my domain?">
    1. Go to the **Emails** tab
    2. Input the domain you want to send from.
    3. Follow the instructions to add the DNS records to your domain's nameservers

    Once your email sending domain is verified, Hercules will be able to send emails from any email address with that domain.
  </Accordion>

  <Accordion title="How do I verify a domain I purchased from Hercules?">
    1. Go to the **Emails** tab
    2. Input the Hercules domain you purchased.
    3. Follow the instructions to add the DNS records to your domain purchased on Hercules.
    4. Go to your Hercules purchased domain in the **Domain page**.
    5. Click **DNS Records** under you domain.
    6. Click **+ Add Record** and add your DNS records.

    Once verified, Hercules will be able to send emails from any email address with that domain.
  </Accordion>

  <Accordion title="Can I customize how my emails look?">
    Yes. Ask Hercules to update the design of your emails. You can change colors, layout, logo, and
    content by describing what you want.
  </Accordion>

  <Accordion title="What happens if an email fails to deliver?">
    Failed emails show up as bounced in the Emails tab with a reason. Hercules stops sending to
    addresses that permanently bounce to protect your sender reputation.
  </Accordion>

  <Accordion title="What is the difference between verifying an email and a domain?">
    Verifying an email address lets you send from that specific email address. Verifying a domain lets
    you send from any email address on that domain. Email verification is faster (click a link), while
    domain verification requires adding CNAME records to your DNS.
  </Accordion>

  <Accordion title="Is there a limit on how many emails I can send?">
    Yes, your plan determines your monthly email limit.

    1. Free: 100 emails / month
    2. Pro: 10,000 emails / month
    3. Business: 100,000 emails / month

    If you need to send more emails, please contact support.
  </Accordion>

  <Accordion title="Do I need a separate email service like SendGrid or Mailgun?">
    No. Hercules Emails handles everything. No external provider or API key is required.
  </Accordion>

  <Accordion title="My email is verified but I am still receiving a 403 error">
    Your domain or email may be verified however, you may still be seeing an error when trying to send an email saying "Sender '[hello@my-domain.com](mailto:hello@my-domain.com)' is not a verified identity for this website" when calling
    `hercules.email.send()`.

    This usually automatically resolves itself within 5 minutes. This is a known issue we are actively
    investigating. If it persists after
    5 minutes, please report an issue.
  </Accordion>

  <Accordion title="My emails are going to spam. How do I fix?">
    1. **Check your Hercules email configuration setup.** Make sure your email is properly set up and says "verified".
    2. **Make sure your email domain is correctly configured**
       Use the following 3rd party tools to confirm everything is configured correctly:

    * [Google Admin Toolbox](https://toolbox.googleapps.com/apps/checkmx/)
    * [EasyDMARC SPF Lookup](https://easydmarc.com/tools/spf-lookup)
    * [MXToolbox Email Health](https://mxtoolbox.com/emailhealth/)
    * [MXToolbox Deliverability](https://mxtoolbox.com/deliverability)
    * [GMass Analyze](https://www.gmass.co/analyze#)

    3. **Check public spam reports.**
       Use the following 3rd party tools to see if your domain is flagged:

    * [Google Postmaster](https://postmaster.google.com/)
    * [Microsoft SNDS](https://sendersupport.olc.protection.outlook.com/snds/),
    * [Spamhaus](https://check.spamhaus.org/results/),
      [MXToolbox Blacklist](https://mxtoolbox.com/blacklists.aspx)

    4. **Test deliverability.**
       Send a test email to a public inbox and check where it lands:

    * [Mail Tester](https://www.mail-tester.com/),
    * [Mail Genius](https://www.mailgenius.com/),
    * [GMass Inbox](https://www.gmass.co/inbox)

    Finally, you can also investigate 3rd party "mail warming" tools
  </Accordion>
</AccordionGroup>
