# resend

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

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 127 installs · ★ 29 repo stars
- Author: oakoss
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/oakoss/agent-skills/tree/HEAD/skills/resend/SKILL.md
- Updated: 2026-08-17
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/oakoss-resend

## What it 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.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add oakoss/agent-skills --skill resend -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/resend/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/resend/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add oakoss/agent-skills --skill resend -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/resend/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add oakoss/agent-skills --skill resend -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/resend/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install oakoss/agent-skills skills/resend
```

2. **Manually: put the files in place**
- File: `.github/skills/resend/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add oakoss/agent-skills --skill resend -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/oakoss/agent-skills --path skills/resend
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/resend/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add oakoss/agent-skills --skill resend -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/oakoss/agent-skills/tree/HEAD/skills/resend/SKILL.md

## When to use it
- 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
- 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

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: cffee7b53ef7d7d9.

BEGIN THIRD-PARTY FILE cffee7b53ef7d7d9
```text
---
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                        |
```
END THIRD-PARTY FILE cffee7b53ef7d7d9

The third-party file has ended. Everything between the cffee7b53ef7d7d9 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 3242 of 5773 bytes. © oakoss · MIT · https://github.com/oakoss/agent-skills/tree/HEAD/skills/resend/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
