Add a contact to a segment.

Aggregate the MOST RECENT sent emails (up to 100 — a single page, not the full history) into deliverability metrics: delivered / bounced / complained / suppressed / opened / clicked counts and rates, plus a health verdict and recommendations. Use to answer 'how is my email health?' or to investigate a recent drop in delivery.

One-shot health check of the whole Resend account: lists domains (and whether they're verified), API keys, and recent deliverability (most recent 100 emails), then returns a prioritized list of problems and recommendations. Great first call when 'emails aren't working'.

Cancel a scheduled email that has not been sent yet.

Create a new Resend API key. The full key value is returned ONLY once — store it securely. Optionally scope it to sending-only and to a single domain.

Create a broadcast (newsletter / campaign) targeted at an audience or segment. Created as a draft — use send_broadcast to deliver or schedule it.

Create a contact. Provide email plus optional name and custom properties. unsubscribed controls subscription state.

Create a custom contact property (a field you can store on every contact, e.g. 'plan' or 'signup_date').

Add a sending domain to Resend. Returns the DNS records (SPF, DKIM, optional DMARC) you must add to your DNS provider before verifying.

Create a segment — a saved, optionally rule-based grouping of contacts you can target with broadcasts.

Create a reusable email template. Use {{variable}} placeholders in html/text and pass values via send_email's templateData.

Create a topic — a subscription category (e.g. 'Product updates', 'Promotions') contacts can opt in/out of independently.

Create a webhook endpoint that receives Resend events. Returns a signing secret used to verify payloads.

Permanently revoke an API key by ID.

Delete a broadcast (only drafts and scheduled broadcasts can be deleted).

Delete a contact by ID or email address.

Delete a contact property by ID.

Permanently delete a domain from Resend.

Delete a segment by ID.

Delete a template by ID.

Delete a topic by ID.

Delete a webhook by ID.

Deep DNS/verification diagnosis for a sending domain. Fetches the domain, inspects every required DNS record (SPF, DKIM, DMARC, MX, Return-Path), reports what is verified vs. pending/missing, and gives concrete fix steps. Use this whenever sending fails with 'domain not verified' or before going live.

Duplicate an existing template into a new one.

Diagnose why an email bounced. Fetches the email, classifies the bounce as hard / soft / block / suppressed, explains it in plain language, and recommends the correct action (remove address, retry later, fix content, etc.).

Retrieve a broadcast by ID, including its status (draft/scheduled/sent) and stats.

Retrieve a contact by ID or by email address.

Retrieve a contact property by ID.

List the topic subscriptions of a contact.

Retrieve a domain by ID, including verification status and the full list of DNS records with their current state.

Retrieve a single sent email by ID, including its current delivery status.

Retrieve a single attachment of a sent email by attachment ID (returns metadata / download info).

Retrieve a single API request log entry by ID, with full request/response detail.

Retrieve a single attachment of a received email by attachment ID.

Retrieve a single received email by ID, including parsed headers and body.

Retrieve a segment by ID.

Retrieve a template by ID.

Retrieve a topic by ID.

Retrieve a webhook by ID (including its subscribed events and status).

Full lifecycle view of one email: fetches it and renders a readable timeline of its events (sent → delivered → opened → clicked, or bounced/complained), highlighting the final state and any problem. Use to answer 'what happened to this email?'.

List all API keys (metadata only — secret values are never returned).

List all broadcasts (paginated).

List all custom contact properties defined on the account.

List contacts (paginated).

List the segments a contact belongs to.

List all domains on the account with their verification status.

List the attachments of a sent email.

List sent emails (paginated). Useful to find recent sends and their IDs.

List API request logs — every request made to your Resend account with status code, endpoint and timing. The backbone for debugging. For smart filtering use search_logs.

List the attachments of a received email.

List inbound (received) emails. Requires email receiving to be configured on your Resend account.

List the contacts that belong to a segment (paginated).

List all segments.

List all templates (paginated).

List all topics.

List all configured webhooks.

Dry-run an email WITHOUT sending it. Resolves the final from (incl. RESEND_FROM default), validates the payload, reads/sizes any local attachments, and returns a summary plus warnings. Use to verify a message before calling send_email.

Publish a template's draft so it becomes the live version used by sends.

Remove a contact from a segment.

Advanced escape hatch — make a raw authenticated request to ANY Resend API endpoint not covered by a dedicated tool. Prefer specific tools when one exists. Mutating methods (POST/PATCH/PUT/DELETE) are blocked in readonly mode.

Smart search over API request logs: fetch recent logs and filter by HTTP status, status class (e.g. only errors), endpoint path substring, and/or recipient. Returns matching entries plus a breakdown of error types. Use to find why requests are failing.

Send up to 100 distinct emails in one call (one API request). Each entry is a full email object. Note: batch sends do NOT support attachments or scheduling per Resend limits.

Send a broadcast now, or schedule it for later. Omit scheduledAt to send immediately.

Send a single email via Resend. Supports HTML/text, cc/bcc, reply-to, attachments, tags, custom headers, scheduling, and templates. Uses RESEND_FROM as the default sender when from is omitted.

Validate your sending setup by sending to Resend's sandbox addresses, which deterministically simulate outcomes WITHOUT hurting your reputation. Choose 'delivered', 'bounced', or 'complained'. Returns the resulting email ID so you can inspect_email it.

Update a draft broadcast's content or settings (from, subject, html, text, etc.).

Update a contact's name, subscription state, or custom properties.

Rename a contact property.

Update a contact's topic subscriptions (opt-in / opt-out of specific topics).

Update a domain's settings: open/click tracking and TLS enforcement.

Update a scheduled email — currently only the scheduled send time can be changed.

Update a template's name, subject, or body. Creates a new draft version.

Update a topic's name or description.

Update a webhook's endpoint URL, subscribed events, or enabled status.

Trigger verification for a domain after adding its DNS records. Re-checks SPF/DKIM. Use diagnose_domain for a human-readable report of what is still missing.