Unlimited private email addresses on demand.

Test with real emails. Create private addresses from code then send and receive with them. The Email Account API.

Trusted By

PanasonicSymantecNIBLesMills

Test your application fully

Test email sign-up, password reset, notifications and more. Know that your app works completely for new users.

Email addresses in code

A REST API for generating, sending, and receiving real emails. Plus support for Javascript, Java, Python and more.

Send, parse and verify emails

Test how your app handles emails by composing and sending emails real in tests. Receive and extract email content.

Code Examples


// javascript client
import { MailSlurp } from "mailslurp-client"
const api = new MailSlurp({ apiKey: "test" })

// create a new private email address
const { id, emailAddress } = await api.createNewEmailAddress()

// receive email
const receivedEmail = await api.fetchLatestEmail(emailAddress)

// send email 
const email = { to: ['support@myapp.com'], body: 'hello!' }
await api.sendEmailSimple(email)

// send from a known address
await api.sendEmail(id, email)


// javascript jest example. other SDKs and REST APIs available
import { MailSlurp } from "mailslurp-client"
const api = new MailSlurp({ apiKey: "test" })

test('my app can receive and handle emails', async () => {
    // create a new email address for this test
    const inbox = await api.createInbox()

    // send an email from the address to your application
    await api.sendEmail(inbox.id, { to: [myAppAddress] })

    // assert that app has handled the email
    expect(myAppReceivedEmail()).resolves.toBe(true)
})


// can your app handle inbound emails
import { MailSlurp } from "mailslurp-client"
const api = new MailSlurp({ apiKey: "test" })

test('my app can send emails', async () => {
    // create a new email address for this test
    const inbox = await api.createInbox()

    // trigger an app action that sends an email
    await signUpForMyApp(inbox.emailAddress)

    // fetch welcome email from the inbox
    const emails = await api.getEmails(inbox.id, { minCount: 1 })

    // assert that the correct email was sent
    expect(emails[0].length).toBe(1)
    expect(emails[0].content).toBe(expectedContent)
})


// use mailslurp to fetch signup verification codes
import { MailSlurp } from "mailslurp-client"
const api = new MailSlurp({ apiKey: "test" })

test('user can sign up and verify account', async () => {
    // create a new email address for this test
    const inbox = await api.createInbox()

    // trigger an app action that sends an email
    signUpForMyApp(inbox.emailAddress)

    // fetch account verification email from the inbox
    const emails = await api.getEmails(inbox.id, { minCount: 1 })

    // parse the verification code from the email contents
    const verificationCode = /code = (.*)/.exec(emails[0].content)[1]

    // use verification code to finish sign up
    await verifyAccountInApp(inbox.emailAddress, verificationCode)

    // assert that app verified user account
    expect(userIsVerified(inbox.emailAddress)).resolves.toBe(true)
})

Get Started Documentation