Resend Examples

This project provides implementation examples for various Resend capabilities within a Next.js 16 (App Router) environment using JavaScript and Tailwind CSS 4.

Available Example Categories

Sending Emails

• Basic Send: Simple HTML email sending via API routes.
• With Attachments: Sending emails with file attachments.
• With CID Attachments: Embedding inline images using CID.
• With Templates: Utilizing Resend's hosted templates.
• With React Email: Building emails using React components.
• Scheduled Sending: Scheduling emails for future delivery.

Forms & Server Actions

• Contact Form: Implementing a Server Action that performs batch sends.

Receiving Emails

• Inbound Emails: Receiving and forwarding emails via webhooks.

Management

• Audiences: Managing contacts and segments.
• Domains: Creating domains and viewing DNS records.
• Automations: Building event-driven workflows and inspecting runs.

Advanced

• Better Auth: Implementing authentication with email verification.
• Prevent Threading: Techniques to stop Gmail from grouping emails into threads.

This repository provides comprehensive examples for sending and receiving emails across various stacks. The following frameworks and languages are supported:

The examples in this repository cover several core Resend functionalities:

Sending Emails

• Basic Send: Simple HTML email delivery.
• With Attachments: Sending files via URL or base64.
• With CID Attachments: Using Content-ID for inline/embedded images.
• With Templates: Using Resend-hosted templates.
• With React Email: Using React component templates (available in Next.js examples).
• Scheduled Send: Scheduling email delivery for a future time.

Forms & Server Actions

• Contact Form: Implementing batch sends with confirmation and notifications.

Receiving Emails

• Inbound Webhooks: Receiving and forwarding incoming emails.
• Webhook Verification: Validating webhook signatures for security.

Management

• Audiences: Managing contacts and segments.
• Domains: Creating and verifying domains.

Advanced

• Authentication: Email verification using better-auth.
• Prevent Threading: Techniques to stop Gmail from grouping emails into conversations.

The project is organized into the following structure to separate Resend logic from UI components and routing:

• src/lib/server/resend.ts: Contains the Resend client initialization.
• src/lib/components/: Reusable UI components like PageHeader.svelte and ResultDisplay.svelte.
• src/routes/: Defines the application routes:
  • api/: Contains API route handlers for various email operations (e.g., send/, send-attachment/).
  • send-email/, attachments/, etc.: Dedicated pages for demonstrating specific Resend features.

src/
  lib/
    server/
      resend.ts      # Resend client initialization
    components/
      PageHeader.svelte
      ResultDisplay.svelte
  routes/
    +layout.svelte    # Navigation layout
    +page.svelte      # Home page
    api/              # API route handlers
      send/           # Send email endpoint
      send-attachment/ # Attachment endpoint
      ...
    send-email/       # Send email page
    attachments/       # Attachments page
    ...

The repository provides boilerplate applications for common Python web frameworks to demonstrate how to trigger emails via HTTP requests.

Flask

1. Run the app: python examples/flask_app.py
2. Send a request:

curl -X POST http://localhost:5000/send \
  -H "Content-Type: application/json" \
  -d '{"to": "delivered@resend.dev", "subject": "Hello", "message": "Hi from Flask!"}'

FastAPI

1. Run the app: python examples/fastapi_app.py
2. Send a request:

curl -X POST http://localhost:8000/send \
  -H "Content-Type: application/json" \
  -d '{"to": "delivered@resend.dev", "subject": "Hello", "message": "Hi from FastAPI!"}'

Django

1. Navigate to the app: cd django_app
2. Install Django: pip install django
3. Run the server: python manage.py runserver 8001
4. Send a request:

curl -X POST http://localhost:8001/send \
  -H "Content-Type: application/json" \
  -d '{"to": "delivered@resend.dev", "subject": "Hello", "message": "Hi from Django!"}'

# Example: Testing the Flask endpoint
curl -X POST http://localhost:5000/send \
  -H "Content-Type: application/json" \
  -d '{"to": "delivered@resend.dev", "subject": "Hello", "message": "Hi from Flask!"}'

You can run specific example classes using the mvn exec:java command by specifying the exec.mainClass.

Available examples include:

• Basic Email Sending: com.resend.examples.BasicSend
• Batch Sending: com.resend.examples.BatchSend
• With Attachments: com.resend.examples.WithAttachments
• With CID (Inline) Attachments: com.resend.examples.WithCidAttachments
• Scheduled Sending: com.resend.examples.ScheduledSend
• Using Templates: com.resend.examples.WithTemplate
• Prevent Gmail Threading: com.resend.examples.PreventThreading
• Audiences & Contacts: com.resend.examples.Audiences
• Domain Management: com.resend.examples.Domains
• Automations: com.resend.examples.Automations
• Metrics: com.resend.examples.Metrics
• Inbound Email: com.resend.examples.Inbound
• Double Opt-In (Subscribe): com.resend.examples.DoubleOptinSubscribe

# Example: Running Basic Email Sending
mvn compile exec:java -Dexec.mainClass="com.resend.examples.BasicSend"

# Example: Running Double Opt-In Subscription
mvn compile exec:java -Dexec.mainClass="com.resend.examples.DoubleOptinSubscribe" -Dexec.args="user@example.com John"