Supabase Integration

Use GetMailer as your SMTP provider for Supabase Auth emails including confirmations, password resets, and magic links.

Why Use GetMailer with Supabase?

  • Avoid Supabase's default 4 emails/hour rate limit on auth emails
  • Get detailed delivery analytics and tracking for all auth emails
  • Custom domain support for professional email branding
  • Better deliverability with proper SPF, DKIM, and DMARC setup

Prerequisites

  • A GetMailer account with a verified domain
  • An API key linked to your domain
  • A Supabase project (free or paid tier)

Step-by-Step Setup

1

Get Your SMTP Credentials

In your GetMailer dashboard, go to Settings and find your SMTP credentials:

SMTP Host: smtp.getmailer.co
SMTP Port: 587 (TLS) or 465 (SSL)
Username: your-api-key
Password: your-api-key
Note: Your API key serves as both username and password for SMTP authentication.
2

Configure Supabase Auth Settings

In your Supabase dashboard:

  1. Go to Authentication > Settings
  2. Scroll down to SMTP Settings
  3. Toggle Enable Custom SMTP
  4. Enter your GetMailer SMTP credentials
3

Fill in SMTP Configuration

Use these settings in Supabase:

FieldValue
Sender email[email protected]
Sender nameYour App Name
Hostsmtp.getmailer.co
Port587
Usernamegm_your_api_key
Passwordgm_your_api_key
4

Test the Configuration

After saving, click Send test email in Supabase to verify the configuration works correctly.

Customizing Email Templates

Supabase allows you to customize auth email templates. In Authentication > Email Templates, you can modify:

  • Confirm signup - Email verification for new users
  • Invite user - Team invitation emails
  • Magic link - Passwordless login emails
  • Change email address - Email change confirmations
  • Reset password - Password reset emails
Tip: Keep the {{ .ConfirmationURL }} variable in your templates - this is required for the auth links to work.

Troubleshooting

Test email not received

  • Verify your domain is fully verified in GetMailer
  • Check that the sender email uses your verified domain
  • Look in spam/junk folders
  • Check the GetMailer dashboard for delivery status

Authentication errors

  • Ensure you're using the same API key for both username and password
  • Check that your API key is valid and has not been revoked
  • Verify the API key has permission to send from your domain

Emails marked as spam

  • Ensure all DNS records (SPF, DKIM, DMARC) are properly configured
  • Use a custom domain instead of a generic email address
  • Avoid spam trigger words in email content

Verification Checklist

  • 1
    Domain verified in GetMailer with all DNS records
  • 2
    API key created and linked to the domain
  • 3
    SMTP settings configured in Supabase
  • 4
    Test email sent and received successfully
  • 5
    Auth flow tested (signup, login, password reset)

Related

Supabase Integration - GetMailer Docs | GetMailer