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 fromnoreply@mail.mocha.app 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,noreply@yourdomain.com 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.Marketing emails
Mocha supports two kinds of email: transactional and marketing. Transactional emails are triggered by something a user does — like a welcome email when they sign up, or a receipt after a purchase. Marketing emails are ones you choose to send — like newsletters, product announcements, or weekly digests. To set up marketing emails, just ask Mocha to create an email campaign in your app. It’ll handle delivery through your existing email configuration, and automatically manages your subscriber list — including unsubscribe handling so you stay compliant.Broadcast emails count toward your monthly email limit.
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. |