Email your Supabase users in under a minute
If your app is on Supabase and you want to email your users, this is the fastest path from zero to sent. No CSV exports, no Mailchimp setup, no custom scripts. The whole setup takes about a minute.
What you need before you start:
- A Supabase project with at least one user in your database
- A Resend account with a verified sending domain
Step 1: Connect your Supabase project
Start at the BroadcastMail onboarding flow. When prompted to connect your database, you'll be taken to a Supabase-hosted OAuth screen — authorize BroadcastMail and you'll be redirected back.
No keys to copy or paste. BroadcastMail uses the Supabase Management API to provision a dedicated broadcastmail_reader Postgres role on your project. The role has SELECT-only access — it can never write to your database.
Step 2: Pick your user table
BroadcastMail lists the tables in your database. Select the one that holds your users.
If you use Supabase Auth, that's auth.users. If you have a custom profiles or users table, pick that instead. Your email column is detected automatically, and you can correct it in the next step if the guess is wrong.
Step 3: Configure filterable columns
This optional step chooses which columns you can filter recipients by later. If your table has a plan column, select it here and you can send only to users where plan = 'free'.
You can skip this now and add columns later from your connection settings.
Step 4: Add your Resend API key
Still in onboarding, paste in your Resend API key when prompted. BroadcastMail sends a test email to the address on your account. If it arrives, you're ready.
If it doesn't, the most common cause is a domain that isn't fully verified in Resend yet. Check the DNS records in Resend's dashboard and give them a few minutes to propagate.
Step 5: Create your first campaign
After onboarding you land on the campaigns dashboard. Click New campaign and give it a name (internal only, recipients never see it).
First, pick your audience:
- All users: everyone in your user table who isn't suppressed
- Filtered: a specific group based on your configured columns
Then write your subject line and body. Use {{first_name}} or any filterable column to personalise the message. The preview updates live as you type. Hit Send now, or Schedule send for later.
That's it
Your campaign fans out to each recipient individually through your own Resend account. Delivery, opens, and bounces show up in the campaign report once it's sent.
Anyone who unsubscribes is added to your suppression list automatically and excluded from every future campaign. Next, learn how to segment your users or read the deliverability basics.
Email your Supabase users today
Connect your project and send your first campaign in about five minutes. Free up to 500 recipients a month.