Resend

@keeb/resendv2026.07.18.1· 10d agoMODELS

01README

Comprehensive Resend integration: emails, domains, API keys, audiences, contacts, broadcasts. Markdown templates with themable cyberpunk shell.

02Models6

@keeb/resend/emailsv2026.05.22.1emails.ts

Global Arguments

Argument	Type	Required	Description
apiKey	string	yes	Resend API key (https://resend.com/api-keys)
fromAddress?	string	no	Default From header. Optional when every call passes `from` explicitly.

fn send(from?: string, to: union, subject: string, html?: string, text?: string, cc?: union, bcc?: union, reply_to?: union, headers?: record, attachments?: array, tags?: array, scheduled_at?: string, idempotency_key?: string)

Send an email via Resend (POST /emails). Full field support.

Argument	Type	Required	Description
from?	string	no	From header. Falls back to globalArgs.fromAddress.
to	union	yes	Recipient address(es). Up to 50.
subject	string	yes
html?	string	no
text?	string	no
cc?	union	no
bcc?	union	no
reply_to?	union	no
headers?	record	no
attachments?	array	no
tags?	array	no
scheduled_at?	string	no	ISO 8601 timestamp or natural language like 'in 1 min'
idempotency_key?	string	no

fn send_batch(emails: array, idempotency_key?: string)

Send up to 100 emails in one request (POST /emails/batch).

Argument	Type	Required	Description
emails	array	yes
idempotency_key?	string	no

fn get(emailId: string)

Retrieve an email by id (GET /emails/:id).

Argument	Type	Required	Description
emailId	string	yes

fn update(emailId: string, scheduled_at: string)

Reschedule a queued email (PATCH /emails/:id). Only `scheduled_at` is mutable.

Argument	Type	Required	Description
emailId	string	yes
scheduled_at	string	yes	New scheduled time. ISO 8601 or natural language.

fn cancel(emailId: string)

Cancel a scheduled email (POST /emails/:id/cancel).

Argument	Type	Required	Description
emailId	string	yes

fn send_template(to: union, subject: string, from?: string, templateName?: string, markdown?: string, variables: record, cc?: union, bcc?: union, reply_to?: union, tags?: array, scheduled_at?: string, idempotency_key?: string)

Render a markdown template into branded HTML, then send via Resend.

Argument	Type	Required
to	union	yes
subject	string	yes
from?	string	no
templateName?	string	no
markdown?	string	no
variables	record	yes
cc?	union	no
bcc?	union	no
reply_to?	union	no
tags?	array	no
scheduled_at?	string	no
idempotency_key?	string	no

fn render_template(templateName?: string, markdown?: string, variables: record)

Render a markdown template into branded HTML without sending.

Argument	Type	Required
templateName?	string	no
markdown?	string	no
variables	record	yes

Resources

email(infinite)— A Resend email message

emailList(infinite)— Batch send response (array of email ids)

renderedEmail(infinite)— A rendered email body (HTML)

@keeb/resend/domainsv2026.05.22.1domains.ts

Global Arguments

Argument	Type	Required	Description
apiKey	string	yes	Resend API key

fn create(name: string, region?: enum, custom_return_path?: string)

Create a sending domain (POST /domains).

Argument	Type	Required	Description
name	string	yes	Fully qualified domain, e.g. 'mail.example.com'
region?	enum	no	Sending region (default: us-east-1)
custom_return_path?	string	no	Custom Return-Path subdomain (default: 'send')

fn get(domainId: string)

Retrieve a domain by id (GET /domains/:id).

Argument	Type	Required	Description
domainId	string	yes

fn update(domainId: string, click_tracking?: boolean, open_tracking?: boolean, tls?: enum)

Update domain settings (PATCH /domains/:id). Toggle click/open tracking and TLS.

Argument	Type	Required
domainId	string	yes
click_tracking?	boolean	no
open_tracking?	boolean	no
tls?	enum	no

fn verify(domainId: string)

Trigger DNS verification (POST /domains/:id/verify).

Argument	Type	Required	Description
domainId	string	yes

fn list()

List all sending domains (GET /domains).

fn delete(domainId: string)

Delete a sending domain (DELETE /domains/:id).

Argument	Type	Required	Description
domainId	string	yes

Resources

domain(infinite)— A Resend sending domain (includes DNS records to add)

domainList(infinite)— List of Resend sending domains

@keeb/resend/api_keysv2026.05.22.1api_keys.ts

Global Arguments

Argument	Type	Required	Description
apiKey	string	yes	Resend API key with full_access permission (required to manage keys)

fn create(name: string, permission: enum, domain_id?: string)

Create an API key (POST /api-keys). Plaintext token is returned ONCE.

Argument	Type	Required	Description
name	string	yes	Human-readable name
permission	enum	yes
domain_id?	string	no	Restrict sending_access keys to a single domain

fn list()

List all API keys (GET /api-keys). Tokens are not included.

fn delete(apiKeyId: string)

Revoke an API key (DELETE /api-keys/:id).

Argument	Type	Required	Description
apiKeyId	string	yes

Resources

apiKey(infinite)— A Resend API key (token only returned on create)

apiKeyList(infinite)— List of Resend API keys

@keeb/resend/audiencesv2026.05.22.1audiences.ts

Global Arguments

Argument	Type	Required	Description
apiKey	string	yes	Resend API key

fn create(name: string)

Create an audience (POST /audiences).

Argument	Type	Required	Description
name	string	yes	Audience name, e.g. 'Registered Users'

fn get(audienceId: string)

Retrieve an audience (GET /audiences/:id).

Argument	Type	Required	Description
audienceId	string	yes

fn list()

List all audiences (GET /audiences).

fn delete(audienceId: string)

Delete an audience (DELETE /audiences/:id).

Argument	Type	Required	Description
audienceId	string	yes

Resources

audience(infinite)— A Resend contact audience

audienceList(infinite)— List of audiences

@keeb/resend/contactsv2026.05.22.1contacts.ts

Global Arguments

Argument	Type	Required	Description
apiKey	string	yes	Resend API key

fn create(audienceId: string, email: string, first_name?: string, last_name?: string, unsubscribed?: boolean)

Add a contact to an audience.

Argument	Type	Required
audienceId	string	yes
email	string	yes
first_name?	string	no
last_name?	string	no
unsubscribed?	boolean	no

fn get(audienceId: string, contactIdOrEmail: string)

Fetch a contact by id or email.

Argument	Type	Required	Description
audienceId	string	yes
contactIdOrEmail	string	yes

fn update(audienceId: string, contactIdOrEmail: string, first_name?: string, last_name?: string, unsubscribed?: boolean)

Update a contact (name fields or unsubscribed state).

Argument	Type	Required
audienceId	string	yes
contactIdOrEmail	string	yes
first_name?	string	no
last_name?	string	no
unsubscribed?	boolean	no

fn delete(audienceId: string, contactIdOrEmail: string)

Remove a contact from an audience (accepts id or email).

Argument	Type	Required	Description
audienceId	string	yes
contactIdOrEmail	string	yes

fn list(audienceId: string)

List all contacts in an audience.

Argument	Type	Required	Description
audienceId	string	yes

Resources

contact(infinite)— A contact inside a Resend audience

contactList(infinite)— List of contacts for an audience

@keeb/resend/broadcastsv2026.05.22.1broadcasts.ts

Global Arguments

Argument	Type	Required	Description
apiKey	string	yes	Resend API key
fromAddress?	string	no	Default From header for broadcasts created without one

fn create(audience_id: string, from?: string, subject: string, html?: string, text?: string, reply_to?: union, name?: string)

Create a broadcast targeting an audience.

Argument	Type	Required	Description
audience_id	string	yes
from?	string	no	From header. Falls back to globalArgs.fromAddress.
subject	string	yes
html?	string	no
text?	string	no
reply_to?	union	no
name?	string	no	Internal name for the broadcast

fn get(broadcastId: string)

Retrieve a broadcast (GET /broadcasts/:id).

Argument	Type	Required	Description
broadcastId	string	yes

fn send(broadcastId: string, scheduled_at?: string)

Send a broadcast immediately, or schedule it.

Argument	Type	Required	Description
broadcastId	string	yes
scheduled_at?	string	no	ISO 8601 timestamp or natural language like 'in 1 hour'. Omit for immediate send.

fn list()

List all broadcasts.

fn delete(broadcastId: string)

Delete a broadcast (DELETE /broadcasts/:id).

Argument	Type	Required	Description
broadcastId	string	yes

Resources

broadcast(infinite)— A Resend broadcast (audience-targeted email campaign)

broadcastList(infinite)— List of broadcasts

03Stats

85 / 100

Downloads

Archive size

425.9 KB

Has README or module doc2/2earned
README has a code example1/1earned
README is substantive1/1earned
Most symbols documented1/1earned
No slow types (deprecated)1/1earned
Dependencies pass trust audit2/2earned
Has description1/1earned
Platform support declared (or universal)2/2earned
License declared1/1earned
Verified public repository0/2missing

Repository

https://github.com/keeb/swamp-resend

04Platforms

linux · x86_64 linux · aarch64 macOS · x86_64 macOS · aarch64

05Labels

#resend #email #transactional #broadcast #smtp