Inbox creation guide

Compare mailbox creation options in MailSlurp API, SDK client libraries, and dashboard for randomized, custom, short, virtual, and temporary addresses.

  • Table of contents

MailSlurp email accounts are called inboxes. You can use the API, dashboard, or SDK client libraries.

Basic example: use random address

You can create email accounts with randomized addresses using MailSlurp domains.

// create a randomly assigned email address
const mailslurp = new MailSlurp({ apiKey });
const { id, emailAddress } = await mailslurp.createInbox();

Use custom domain

Register a domain to use custom email addresses:

const { emailAddress } = await mailslurp.createInbox({
  emailAddress: "test5@mydomain.com",
});

Use short addresses

To generate email addresses under 31 characters use the useShortAddress option:

const inbox = await mailslurp.inboxController.createInboxWithOptions({
  createInboxDto: {
    useShortAddress: true,
  },
});
expect(inbox.emailAddress.length).toBeLessThan(31);

Virtual inboxes

Virtual mailboxes will never send to external recipients and can be used as a mail trap:

const inbox = await mailslurp.inboxController.createInboxWithOptions({
  createInboxDto: {
    useShortAddress: true,
  },
});
expect(inbox.emailAddress.length).toBeLessThan(31);

Temporary mailboxes

For throwaway temp email accounts use the expiresIn options:

const inbox = await mailslurp.inboxController.createInboxWithOptions({
  createInboxDto: {
    useShortAddress: true,
  },
});
expect(inbox.emailAddress.length).toBeLessThan(31);

More options

See the creating inboxes guide for more examples.

Email and SMS Platform
Create a free account in 3 clicks