Sending email

The send() method dispatches a single email through your SES infrastructure. It returns a messageId on success.

Basic usage

import { WrapsEmail } from '@wraps.dev/email';

const email = new WrapsEmail({ region: 'us-east-1' });

const result = await email.send({
  from: '[email protected]',
  to: '[email protected]',
  subject: 'Welcome!',
  html: '<h1>Hello from Wraps!</h1>',
});

console.log('Sent:', result.messageId);

Examples

HTML
React Email
With attachments
Multiple recipients

await email.send({
  from: '[email protected]',
  to: '[email protected]',
  subject: 'Welcome!',
  html: '<h1>Hello from Wraps!</h1>',
});

import { WrapsEmail } from '@wraps.dev/email';
import { WelcomeEmail } from './emails/Welcome';

const email = new WrapsEmail();

await email.send({
  from: '[email protected]',
  to: '[email protected]',
  subject: 'Welcome!',
  react: <WelcomeEmail name="Alice" />,
});

await email.send({
  from: '[email protected]',
  to: '[email protected]',
  subject: 'Your Invoice',
  html: '<p>Invoice attached.</p>',
  attachments: [
    {
      filename: 'invoice.pdf',
      content: pdfBuffer, // Buffer or base64 string
      contentType: 'application/pdf',
    },
  ],
});

await email.send({
  from: '[email protected]',
  to: ['[email protected]', '[email protected]'],
  cc: '[email protected]',
  replyTo: '[email protected]',
  subject: 'Team update',
  html: '<p>See attached for details.</p>',
});

Parameters

from

string

required

Sender email address. Must be a domain or address verified in SES. Use the format '[email protected]' or 'Your App <[email protected]>'.

string | string[]

required

Recipient email address or array of addresses.

subject

string

required

Email subject line.

html

string

HTML body content. Provide html, text, or react — at least one is required.

text

string

Plain text body content. Recommended alongside html for email clients that do not render HTML.

react

ReactElement

A React Email component. The SDK renders it to HTML before sending. Requires react and @react-email/render to be installed in your project.

attachments

object[]

File attachments to include.

Show attachment properties

filename

string

required

File name shown in the email client (e.g. 'invoice.pdf').

content

Buffer | string

required

File content as a Buffer or base64-encoded string.

contentType

string

required

MIME type of the attachment (e.g. 'application/pdf', 'image/png').

replyTo

string

Reply-to email address. Defaults to the from address if not set.

string | string[]

CC recipient email address or array of addresses.

bcc

string | string[]

BCC recipient email address or array of addresses.

Return value

send() returns a promise that resolves to:

messageId

string

The SES message ID assigned to the sent email. Use this for tracking and debugging.

Notes

The from address must belong to a domain verified in SES. Run wraps email domains verify -d yourdomain.com to check verification status.

If your SES account is in sandbox mode, you can only send to verified email addresses. Request production access in the AWS console to send to any recipient.

Email SDK

SMS SDK

IaC Integrations

Sending email

Basic usage

Examples

Parameters

Return value

Notes

Build docs developers (and LLMs) love

Email SDK

SMS SDK

IaC Integrations

​Basic usage

​Examples

​Parameters

​Return value

​Notes

Build docs developers (and LLMs) love

Basic usage

Examples

Parameters

Return value

Notes