Supabase Over Email Send Rate Limit Error

Quick Answer

Rate-limit client-side and add backoff before resending. If that does not apply, debounce the resend button (e.g. a 60-second countdown) — the full checklist is below.

Error Code

Error code: over_email_send_rate_limit
Official name: over_email_send_rate_limit
Service: Supabase

What does this error mean?

Too many emails have been sent to this email address. Ask the user to wait a while before trying again.

Common Causes

• Rapid retries of signUp or resend confirmation
• Burst of OTP requests to the same address
• A React effect or loop calling resend() on every render
• Sending to an address that hard-bounces - GoTrue stops sending after repeated failures

How to Fix

1. Rate-limit client-side and add backoff before resending
2. Debounce the resend button (e.g. a 60-second countdown)
3. Never call resend() inside a useEffect without a dependency guard
4. Wait for the per-address rate-limit window to pass
5. Check auth logs for hard bounces and clean invalid addresses from your user list

Code Examples

if (error?.code === 'over_email_send_rate_limit') {
  showError('Too many emails sent. Please wait a few minutes.')
  disableResendFor(120000)
}

Framework-Specific Fixes

const [cooldown, setCooldown] = useState(0)
if (cooldown > 0) {
  // button disabled, show remaining seconds
}
const { error } = await supabase.auth.resend({ type: 'signup', email })
if (error?.code === 'over_email_send_rate_limit') {
  setCooldown(120) // honor the server window
}

You Might Also Like

Frequently Asked Questions

Recommended Tools

Recommendations are editorial — DB Error Reference takes no payment or affiliate fees for tool listings.

Official Sources

This page is based on the official Supabase documentation linked below and adds practical troubleshooting guidance on top.

• Supabase Auth Error Codesofficial