Overview
Lovable is an AI-powered platform that lets you build full-stack web apps from natural language prompts. You can integrate Brew into any Lovable project to send on-brand emails triggered by user actions in your app. Brew works with Lovable through its REST API. Since the API requires an API key, Lovable uses Supabase Edge Functions to keep your credentials secure.What Brew Handles for You
Building email into an app usually means writing HTML templates, handling unsubscribes, managing bounces, and worrying about deliverability. Brew takes care of all of that so you can focus on your app.- On-brand design without HTML - Describe your email in plain language. Brew generates production-ready, responsive emails that match your brand’s colors, fonts, logo, and tone of voice. No HTML coding or email design skills needed.
- Compliance built in - Marketing emails (automations and campaigns) automatically include a physical address and unsubscribe link in the footer. Brew’s preflight audit blocks any send that’s missing required compliance elements, keeping you aligned with CAN-SPAM and GDPR.
- Unsubscribe management - Brew handles the entire unsubscribe flow: a branded unsubscribe page, contact status updates, and automatic suppression from future marketing sends. You don’t need to build any of this yourself.
- Bounce and complaint handling - Hard bounces and spam complaints are automatically suppressed, protecting your sender reputation without any code on your end.
- Contact auto-creation - When you trigger an automation or send a transactional email, Brew automatically creates or updates the contact record. No separate contact creation step needed in your app.
- Works across every email client - Gmail, Outlook, Apple Mail, Yahoo, mobile - email HTML is notoriously tricky. Every email Brew generates is responsive and tested across clients.
- Analytics without instrumentation - Opens, clicks, bounces, and deliverability are tracked automatically in Brew’s dashboard. No event tracking code required in your Lovable app.
Three Ways to Send Emails with Brew
Brew has three types of emails. Here’s how each one works in the context of a Lovable app:| Type | What it does | How it’s triggered |
|---|---|---|
| Automations | Multi-step email sequences with delays, branching, and conditions. Think welcome series, onboarding drips, or order follow-ups. | Triggered from your Lovable app via API when an event happens (user signs up, places an order, etc.) |
| Transactional | Single, immediate emails for things like password resets, receipts, or account notifications. | Triggered from your Lovable app via API when a user action requires an instant email. |
| Campaigns | One-time sends to a segment of your audience. Think newsletters, product announcements, or promotions. | Created and sent (or scheduled) inside Brew’s dashboard. Not triggered from your app. |
Prerequisites
Brew Account
Sign up at brew.new and set up your brand.
Verified Domain
Verify your sending domain to send emails from your own address.
API Key
Create a new API key in Settings → API in your Brew dashboard.
Lovable with Supabase
Connect Supabase to your Lovable project to use Edge Functions.
Connect Brew to Lovable
These steps apply to both automations and transactional emails.Connect Supabase to your Lovable project
Lovable uses Supabase Edge Functions to securely handle API keys. If you haven’t connected Supabase yet, click the Supabase icon in your Lovable project and follow the authorization steps.
Add your Brew API key as a secret
In your Lovable project, go to Supabase → Secrets:
- Add a new secret with the name
BREW_API_KEY - Paste your Brew API key as the value
Automations
Automations are multi-step email flows you design in Brew and trigger from your Lovable app when something happens, like a user signing up, placing an order, or abandoning a cart. Brew handles the entire sequence: delays, branching, follow-ups.Set up in Brew
Create your automation
In Brew, go to the Create page, select Automation, and describe the flow you want. For example: “Create a 3-email welcome series for new users. First email welcomes them, second shares a quick-start guide, third nudges them to book a demo.”
Set an event ID and define your payload
Give your automation a descriptive event ID like
user_signup or order_placed. Define the payload schema (the data your app will send), for example: email, firstName, plan.Learn more about building automations in the Automations guide.
Prompt Lovable
Copy and paste this prompt into Lovable’s chat:When to use automations
- User signup - Trigger
user_signupto start a welcome series - Onboarding - Trigger
onboarding_startedto send a multi-step getting started sequence - Trial ending - Trigger
trial_endingto send a reminder sequence nudging users to upgrade - Re-engagement - Trigger
user_inactiveto win back users who haven’t logged in recently
Transactional Emails
Transactional emails are single, immediate emails sent when a user action requires an instant response, like a password reset link or an order receipt.Set up in Brew
Create your transactional email
In Brew, go to the Create page, select the Transactional tab, and describe the email you need. For example: “Create a password reset email with a reset link and expiry time.”
Add variables
Use triple curly braces for dynamic content:
{{{firstName}}}, {{{resetUrl}}}. Brew’s AI will often insert these automatically based on your prompt.Learn more about creating transactional emails in the Transactional Emails guide.
Prompt Lovable
Copy and paste this prompt into Lovable’s chat:subject, from, and replyTo fields to the request body.
When to use transactional emails
- Password resets - Send a reset link immediately when requested
- Order receipts - Confirm a purchase the moment it’s completed
- Payment failed - Notify the user instantly so they can update their payment method
- Account notifications - Plan upgrades, billing alerts, security events
Test Your Integration
Once Lovable finishes generating the code, trigger the email flow in your app (for example, submitting a signup form or requesting a password reset). Check your email analytics in Brew to confirm the email was delivered.Troubleshooting
Emails are not being sent
Emails are not being sent
Make sure your
BREW_API_KEY is correctly added in Supabase Secrets. Also verify that your sending domain is verified in Brew by checking Settings → Domains in your dashboard.Getting a 401 Unauthorized error
Getting a 401 Unauthorized error
Missing required variables or payload fields
Missing required variables or payload fields
For transactional emails, make sure the
variables object includes all variables used in your template. For automations, make sure the payload includes email and all required fields defined in your schema. Field names are case-sensitive.Automation not triggering
Automation not triggering
Verify that the automation is published and active in Brew. Check that the event ID in your API call matches the one configured in Brew. The automation status must be
active, not draft or paused.Emails landing in spam
Emails landing in spam
Make sure you have completed domain verification including DKIM and SPF records. We recommend using a subdomain like
updates.yourdomain.com for sending.Lovable shows build errors
Lovable shows build errors
Lovable may sometimes show false positive build errors. Test your app live by triggering the actual email flow. If the Edge Function deploys successfully in Supabase, the integration is likely working.
Need Help?
Our team is ready to support you at every step of your journey with Brew. Choose the option that works best for you:- Self-Service Tools
- Talk to Our Team
Search Documentation
Type in the “Ask any question” search bar at the top left to instantly find relevant documentation pages.
ChatGPT/Claude Integration
Click “Open in ChatGPT” at the top right of any page to analyze documentation with ChatGPT or Claude for deeper insights.