Sending email in Javascript and NodeJS (Typescript examples)

Sending email in Javascript and NodeJS (Typescript examples)

Sending email with MailSlurp is easy. Simply create an inbox and use the inbox's ID with sendEmail() methods.


The basic sendEmail() method has the following signature:

sendEmail(inboxId: string, sendEmailOptions: SendEmailOptions): Promise<Response>

Notice the inboxId. This is the inbox from which the emails will be sent. The second parameter contains properties describing the email to be sent.


The only required property of SendEmailOptions is a to field — which is an array of email addresses.

  "to": [""]

Other optional fields include the following:

interface SendEmaiOptions {
  to: Array<string>;

  // email subject
  subject?: string;

  // extra recipient fields
  cc?: Array<string>;
  bcc?: Array<string>;

  // email contents
  body?: string;

  // array of attachment IDs
  attachments?: Array<string>;

  // map of template variables to substitute in body
  templateVariables?: any;

  // optional headers
  charset?: string;
  replyTo?: string;
  from?: string;

  // is contents HTML?
  html?: boolean;


await mailslurp.sendEmail(inboxId, { to: [""], body: "Hello" });

HTML and templates

You can flag { "html": true } when sending emails to indicate that HTML content is being sent. This is recommend if you want email providers to render markup correctly.

You can also pass a map of templateVariables when sending an email and MailSlurp will look for and interpret Moustache templates within your email body.

  "body": "Hello {{name}}",
  "templateVariables": {
    "name": "tester"


Next steps

That's how sending works at MailSlurp. Let's see it in action by finding the best MailSlurp library or integration for you application or tests.

Integrate MailSlurp &rarr

Related content

Email APIs for Developers & QA

Build powerful applications and test suites using real email addresses in code. Create inboxes on demand then send and r...

Official MailSlurp documentation

Developer documentation and guides for MailSlurp's email APIs. REST, SDKS, Graphql, SMTP and more. MailSlurp is an email...

Ruby Mailer SDK - send and receive emails in Rails, Rspec an...

Receive email and attachments with Rails, Rspec, and Ruby without SMTP using MailSlurp Ruby Gem.

Temporary email api

Temporary email API for disposable email accounts. Free for personal use with REST API and clients in NodeJS, CSharp and...

Mailinator alternative

Alternatives to Mailinator for test email accounts. Create real email addresses using MailSlurp

Generate API clients using Swagger

How to create SDK libraries a language of your choice

Ready to dive in?Start building email applications today.