/Frameworks and tools

How to test email and SMS with Insomnia

This article shows you how to test email and test SMS using Insomnia and the Mailosaur API.

What is Insomnia?

Insomnia a free, cross-platform desktop application that makes it easy to test, interact with and design HTTP-based APIs.

At this stage, we assume that you already know how to use Insomnia, however if not, you can learn more on Insomnia’s website.

What is Mailosaur?

Mailosaur is a service that captures email and SMS messages and lets you test them, via it’s web dashboard and the Mailosaur email/SMS testing API.

If you don’t already have one, create a free account trial now, and send an email into Mailosaur first. Once you have this working, you’re ready to start testing!

1. Create an API key

Account-level API keys allow you to access all the functions described in the API reference, and have access to all the servers in your account.

To create an account-level API key, you must be an Administrator or Account Owner on the account in question.

  1. Go to the Settings page in the Mailosaur Dashboard.
  2. Go to the API Keys page.
  3. Click the Create a Key button.
  4. In the dialog that appears, enter a name for your key.
  5. When you are finished, click Create.

For more information, see our guide on managing API keys.

2. Import the Insomnia Collection

Mailosaur has a public Insomnia Collection which you can access by clicking the button below:

Run in Insomnia

Alternatively, you can import the collection and start testing email and SMS by following these steps:

  1. Open Insomnia.
  2. Click the Create button, in the top right of the screen.
  3. Select URL.
  4. Type in the URL https://mailosaur.com/insomnia.json and click Fetch and Import.

3. Make API requests using your API key

Once you have the collection loaded, you just need to add your Mailosaur API key to your base environment variables.

This can be done by navigating the Manage Environments, then adding your Mailosaur API key as follows:

Insomnia - Manage Environments

That’s it, you’re ready to start testing email and SMS messages with Mailosaur and Insomnia!