Skip to main content
skill CX Codex

resend · oakoss — Claude Code skill: what it does, how to install

Guides AI agents in integrating the Resend email API, handling React Email templates, domain verification, and Svix webhooks.

MIT 127 installs ★ 29 updated 2026-08-17

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add oakoss/agent-skills --skill resend -a claude-code
Open on GitHub

What resend does

This skill teaches coding agents how to work with the Resend email API. It covers sending transactional messages, batch delivery, scheduling, contact lists, and server-side React Email component rendering.

The guidance prevents typical integration bugs. The react property works strictly in the Node.js SDK, while batch operations do not support scheduling or attachments. Total attachments must remain under 40MB after encoding. It also enforces reading RESEND_API_KEY from the environment and verifying incoming Svix webhook signatures.

What it helps with

  • send transactional emails with error handling via Resend
  • set up server-side rendering with React Email components
  • verify domain SPF, DKIM, and DMARC records
  • validate Svix webhook signatures on email events

Example prompts for the agent

  • Write a password reset email handler using Resend and destructure error handling
  • Create a webhook endpoint that verifies Svix signatures for Resend bounce events
  • Set up a transactional receipt template using React Email with Resend

How to install resend

1Skills CLI (Vercel)

npx skills add oakoss/agent-skills --skill resend -a claude-code

2Manually: put the files in place

~/.claude/skills/resend/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/resend/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about resend

How to install resend in Claude Code?

Run npx skills add oakoss/agent-skills --skill resend -a claude-code. Alternatively, place the file in ~/.claude/skills/resend/SKILL.md.

What does the resend skill do?

It provides API patterns and common pitfalls for sending emails, verifying sender domains, handling Svix webhooks, and managing contacts with Resend.

Does the react property work in non-Node SDKs?

No, passing React Email components via the react property is exclusive to the Node.js SDK because it depends on server-side JSX rendering.

Source text

SKILL.md · MIT
---
name: resend
description: 'Resend email API for sending transactional and marketing emails. Use when integrating email delivery, managing domains, handling webhooks, building email workflows with React Email, managing contacts, or sending broadcasts. Use for resend, email, transactional, broadcast, contacts, segments, webhooks, domain.'
license: MIT
metadata:
  author: oakoss
  version: '1.1'
  source: https://resend.com/docs
user-invocable: false
---

# Resend

## Overview

Resend is a modern email API built for developers, providing programmatic email sending with support for React Email components, domain management, and webhook-driven event tracking.

**When to use:** Transactional emails (welcome, password reset, receipts), batch email delivery, scheduled sending, webhook-based delivery tracking, domain verification, React Email integration.

**When NOT to use:** High-volume marketing automation (use dedicated ESP), SMS/push notifications, email hosting/inbox management.

## Quick Reference

| Pattern          | API                                         | Key Points                                                    |
| ---------------- | ------------------------------------------- | ------------------------------------------------------------- |
| Send email       | `resend.emails.send({ from, to, subject })` | Returns `{ data, error }`, supports html/text/react content   |
| Send with React  | `resend.emails.send({ react: <Email /> })`  | Node.js SDK only, renders React Email components server-side  |
| Batch send       | `resend.batch.send([...emails])`            | Multiple emails in one request, no attachments/scheduling     |
| Schedule email   | `emails.send({ scheduled_at })`             | ISO 8601 or natural language, cancel before send window       |
| Attachments      | `emails.send({ attachments: [...] })`       | Max 40MB total after encoding, supports content or path       |
| Idempotent send  | `emails.send(params, { idempotencyKey })`   | Prevents duplicate sends on retry                             |
| Retrieve email   | `resend.emails.get(emailId)`                | Check delivery status and metadata                            |
| Add domain       | `resend.domains.create({ name })`           | Returns DNS records for SPF, DKIM, MX                         |
| Verify domain    | `resend.domains.verify(domainId)`           | Triggers DNS record check                                     |
| List domains     | `resend.domains.list()`                     | Returns all domains with status                               |
| Create webhook   | Dashboard or API                            | Subscribe to email lifecycle events                           |
| Verify webhook   | `resend.webhooks.verify({ payload, ... })`  | Validates Svix signature headers                              |
| Tags             | `emails.send({ tags: [...] })`              | Key-value pairs for categorization, ASCII only, max 256 chars |
| Custom headers   | `emails.send({ headers: {...} })`           | Add custom email headers                                      |
| Create contact   | `resend.contacts.create({ email, ... })`    | Global contacts with custom properties                        |
| List contacts    | `resend.contacts.list()`                    | Returns all contacts                                          |
| Create broadcast | `resend.broadcasts.create({ from, ... })`   | Bulk email to a segment, supports template variables          |
| Send broadcast   | `resend.broadcasts.send(id, { segmentId })` | Delivers broadcast to a segment of contacts                   |

## Common Mistakes

| Mistake                                    | Correct Pattern                                                      |
| ------------------------------------------ | -------------------------------------------------------------------- |
| Using root domain for sending              | Use a subdomain like `send.yourdomain.com` to isolate reputation     |
| Not checking `error` in response           | Always destructure `{ data, error }` and handle errors               |
| Sending attachments in batch requests      | Attachments and scheduling are not supported in batch sends          |
| Hardcoding API key in source code          | Use environment variable `RESEND_API_KEY`                            |
| Skipping webhook signature verification    | Always verify using Svix headers before processing events            |
| Using `react` prop outside Node.js SDK     | The `react` prop only works with the Node.js SDK                     |
| Not setting up DMARC after SPF/DKIM verify | Add DMARC record after SPF and DKIM pass to improve deliverability   |
| Exceeding 50 recipients in a single send   | Use batch send or loop for more than 50 recipients per request       |
| Using `&&` for tag name/value characters   | Tag names and values must be ASCII letters, numbers, `_`, or `-`     |
| Ignoring bounce/complaint webhooks         | Monitor `email.bounced` and `email.complained` to protect reputation |

## Delegation

- **Email template design**: Use `Explore` agent to discover React Email component patterns
- **Domain DNS configuration**: Use `Task` agent for step-by-step DNS setup verification
- **Webhook endpoint setup**: Use `Task` agent for route handler implementation

## References

- [Sending emails, batch sending, attachments, scheduling, and idempotency](references/sending-emails.md)
- [Contacts, Segments, Broadcasts, template variables, and bulk sending](references/contacts-and-broadcasts.md)
- [Domain verification, DNS records, and sender identity management](references/domain-management.md)
- [Webhook events, signature verification, and event handling](references/webhooks.md)

© oakoss · MIT · oakoss/agent-skills

Similar skills

All skills for Backend and APIs →

resend by other authors comes first.

resend resend resend is a Claude Code skill for working with the Resend API, from sending transactional mail to configuring webhooks. It activates for requests about Resend or its SDK. CX Codex +1 24,800installs resend vercel-labs Skill runs a local Resend API that captures emails in memory instead of sending them. Sent messages are accessible via REST or a browser UI. CX Codex +1 246installs resend-cli resend Teaches the agent to drive Resend through the resend CLI: send emails, manage domains, contacts, broadcasts and webhooks. Useful when that work happens in a script or CI. CX Codex +1 14,200installs resend-integration-skills gocallum resend-integration-skills configures Resend email sending via MCP so AI coding agents can dispatch transactional emails and manage contact audiences. CX Codex +1 413installs email-sending claude-dev-suite The email-sending skill covers transactional email, provider APIs, SMTP, and reusable templates. Use it when a project needs welcome messages, alerts, or password emails. CX Codex +1 188installs resend-webhooks hookdeck resend-webhooks sets up Resend webhook handlers, Svix signature checks, and email event processing for Express or FastAPI projects. CX Codex +1 266installs pp-resend Giuliano Giacaglia pp-resend queries Resend data from the agent: pulls recipient history, inspects email delivery timelines, and checks domain health. CX Codex +1 256installs email-systems travisjneuman email-systems — a skill for Claude Code that guides transactional email setup, template design, and deliverability records. Runs when configuring sending infrastructure, building HTML templates, or troubleshooting inboxing. CX Codex +1 132installs

From the same set106

The whole set →
secure-ai secure-ai — a skill that hardens the LLM layer of an app: injection defense, output validation, and zero-trust rules for agents that call tools. CX Codex +1 130installs python-uv python-uv teaches coding agents to manage Python projects with uv: initialization, dependencies, lockfiles, workspaces, and packaging. Useful when migrating from pip and poetry workflows. CX Codex +1 129installs rust This skill guides Rust work across ownership, async services, CLIs, terminal UIs, and testing. Use it when an agent needs Rust-specific patterns. CX Codex +1 128installs github-cli github-cli equips AI coding assistants with gh CLI workflows for pull requests, issues, Actions runs, releases, and API calls. CX Codex +1 128installs tanstack-pacer Hands your agent a map of TanStack Pacer: debouncing, throttling, rate limits and async queues, with the matching React hooks. Useful when a handler fires too often. CX Codex +1 126installs tanstack-devtools tanstack-devtools guides AI coding agents in configuring Query cache, Router, and Form debugging panels across React applications. CX Codex +1 125installs seo-optimizer seo-optimizer — an SEO architecture skill: JSON-LD entities, E-E-A-T signals, topic clusters and a 30-point content audit. Runs in Claude, Codex, Cursor, GitHub Copilot, Gemini CLI and OpenCode. CX Codex +1 125installs performance-optimizer performance-optimizer provides structured workflows for profiling, caching, and full-stack performance tuning. Helps eliminate slow database queries, optimize bundles, and reduce API latency. CX Codex +1 124installs

Project sponsors

Companies that keep this analytics open