Back to Settings

Email Provider Setup Guide

Configure your email service to send video sharing notifications

Why Configure Email?

Cheesebox uses your own email provider to send video sharing notifications. This gives you:

  • Cost Control - Use your existing email service or free tiers
  • Branding - Emails come from your own domain
  • Deliverability - Leverage your established sender reputation
  • Compliance - Use email providers that meet your requirements

Choose Your Email Provider

Create Resend Account

Resend is a modern email API with a simple setup process.

  1. Go to resend.com
  2. Click "Sign Up" and create your account
  3. Verify your email address

Add and Verify Your Domain

For production use, you'll want to verify your own domain. For testing, you can use Resend's sandbox domain.

  1. In Resend dashboard, click Domains → Add Domain
  2. Enter your domain (e.g., yourdomain.com)
  3. Add the DNS records to your domain provider:
    • SPF record
    • DKIM records
    • Return-Path record
  4. Wait for verification (usually a few minutes)

Note: For testing, you can skip domain verification and use Resend's sandbox domain. Emails will only be sent to your verified email address.

Generate API Key

  1. Click API Keys in the sidebar
  2. Click Create API Key
  3. Give it a name (e.g., "Cheesebox")
  4. Select permissions: Sending access
  5. 🔐 Copy the API key (starts with re_)

Important: Save this API key immediately - you won't be able to see it again!

Configure in Cheesebox

Now enter your Resend credentials in the Settings page:

From Email: noreply@yourdomain.com (must match verified domain)
From Name: Cheesebox (optional)
API Key: Your Resend API key
Go to Settings

Common Issues & Troubleshooting

Emails not arriving

  • Check spam folder
  • Verify the "From Email" matches your verified domain/email
  • Check your email provider's dashboard for delivery logs

Authentication failed

  • Double-check username and password
  • For Gmail, ensure you created an app password (not your regular password)
  • For 2FA accounts, use app-specific passwords

Domain not verified

  • Make sure you've added all DNS records
  • Wait a few minutes for DNS propagation
  • Use dig TXT yourdomain.com to check DNS records

Your email credentials are encrypted before being stored and are only used to send notifications.