Resend

Overzicht

Resend verzorgt alle transactionele email vanuit Beam. Twee use cases: team uitnodigingen en CI/CD deploy notificaties.

Use case	Trigger	Template
Team uitnodiging	`POST /team/invite`	HTML met magic link
Deploy success	GitHub Actions	Platte tekst
Deploy failure	GitHub Actions	Platte tekst

Team Uitnodigingen

Flow:

Owner/Admin klikt "Uitnodigen"
  → POST /team/invite
  → Supabase genereert magic link (inviteUserByEmail)
  → Resend verstuurt HTML email
  → Ontvanger klikt link → /auth/callback → /invite/accept?token=...

Email template: HTML met:

Welkomstbericht met naam van de uitnodiger
Primaire CTA button met magic link
Fallback: raw URL als de button niet werkt
From: RESEND_FROM_EMAIL (bijv. BEAM <info@builtwithbeam.com>)

Expiry: 7 dagen. Na verlopen kan de uitnodiging opnieuw verstuurd worden via POST /team/invitations/:id/resend.

Deploy Notificaties

GitHub Actions workflows sturen een email bij success of failure van een deployment. Dit gebruikt de Resend API direct vanuit de workflow (niet via de Beam API).

API Integratie

Endpoint: POST https://api.resend.com/emails

Request:

{
  "from": "BEAM <info@builtwithbeam.com>",
  "to": ["email@example.com"],
  "subject": "Je bent uitgenodigd voor een Beam team",
  "html": "<html>...</html>"
}

Auth: Authorization: Bearer RESEND_API_KEY

Rate Limits

Tier	Limiet
Free	100 emails/dag, 1 domein
Pro	50.000 emails/maand

Beam gebruikt momenteel de free tier. Bij groei naar >100 invites/dag is upgrade nodig.

Error Handling

API failures worden gelogd maar niet doorgestuurd naar de gebruiker
Bij Resend downtime: uitnodiging wordt wel opgeslagen in DB (status: pending), email kan later opnieuw verstuurd worden
Geen retry-mechanisme — handmatige resend via dashboard

Environment Variables

Variabele	Waar	Type
`RESEND_API_KEY`	API Worker	Secret
`RESEND_FROM_EMAIL`	API Worker	Secret

Domeinverificatie

builtwithbeam.com is geverifieerd in Resend met:

SPF record
DKIM signing
DMARC policy

Dit zorgt voor betere deliverability en voorkomt spam-classificatie.