How it works
Just ask Mocha to add email to your app. Tell it something like “send a welcome email when someone signs up” or “add a password reset flow,” and it’ll handle the code for you. You can monitor deliveries, opens, bounces, and more from the Email tab in your dashboard. Want to change how your emails look or what they say? Just prompt. Tell Mocha something like “make the welcome email more colorful” or “add the user’s name to the subject line” and it’ll update the email for you.Testing emails during development
While you’re building and previewing your app, emails are automatically sent from[email protected] and can only be delivered to your own account email. This way you won’t accidentally email real users while testing.
We’re planning to expand this shared Mocha sender for users on our paid tiers in the near future, so you have more flexibility when testing emails during development.
Connecting a domain
To send emails from your own domain, you need to verify that you own it.Connect DNS records
Click Connect. Mocha will open a guided setup that walks you through adding two DNS records to your domain. If your registrar supports it, this can be done automatically with a few clicks.
Set your sender address
Go to Settings > Email to configure the sender address and display name for your emails. This is what recipients will see in their inbox — for example,[email protected] from “My App.” You’ll need a verified domain before you can set a custom sender address.
Email limits
Your monthly email limit depends on your plan:| Plan | Emails per month |
|---|---|
| Free | 10 |
| Bronze | 500 |
| Silver | 2,500 |
| Gold | 10,000 |
Bounces and suppressions
If an email bounces or a recipient marks it as spam, that address is automatically suppressed. Mocha won’t try to send to it again. This protects your domain’s reputation and keeps your delivery rates healthy. You can see all suppressed addresses in the Email tab under Undelivered messages.Common issues
| What you’re seeing | What to do |
|---|---|
| ”Monthly email limit exceeded” | You’ve used all your emails for this month. Upgrade your plan or wait for the next month. |
| Emails only going to your own address | This is normal during development. Publish your app with a verified domain to send to anyone. |
| Domain stuck on “Pending” | DNS changes can take up to 48 hours. If it’s been longer, double-check your DNS records are configured correctly. |
| ”Recipient is suppressed” | That address previously bounced or complained. Mocha won’t send to it to protect your reputation. |
| No sender address configured | Go to Settings > Email and set a default sender email and name. |