Welcome to Mapil

Mapil is an email testing service for developers and QA teams. You send us an email, we'll store it and let you query it using our API.

How's it work?

Create an email address

Create a mail.mapil.co email address (either using our API or the site)

> curl -XPOST -u YOURTOKEN:YOURSECRET https://mapil.co/api/v1/email-addresses/johnsmith@mail.mapil.co

{ "message": "johnsmith@mail.mapil.co created"}

Send an email

Send an email from any client to your Mapil email address.

Check the content

Using our API, you can query the entire email data structure including all headers, attachment names and sizes, HTML content, text content, etc.

> curl -XGET -u YOURTOKEN:YOURSECRET https://mapil.co/api/v1/email-addresses/johnsmith@mail.mapil.co/messages
    

{
  "results": [
        {
            "id": "5715aaf9cfd845e640625158",
            "html": "...",
            "text": "Hello\nFoo",
            "headers": {
                ...
            },
            "subject": "QA Test Email Subject",
            "priority": "normal",
            "from": {
                "0": {
                  "address": "qajohn@example.com",
                  "name": "John Doe"
                }
            },
            "to": {
                "0": {
                  "address": "bar@mail.mapil.co",
                  "name": ""
                }
            }
            "attachments": {
                "0": {
                    "contentType": "image/png",
                    "transferEncoding": "base64",
                    "fileName": "foo.png",
                    "checksum": "8e706b402ce0e8ee010c59f3187b8f38",
                    "length": 169116
                }
            }            
        }
    ]
}          

How is this better than Mailinator, etc.?

• Secure - only you have access to your messages
• Simple, powerful API
• Built with automated testing in mind
• Programatically provision and release email addresses on-the-fly
• Query rendered HTML, plain text, or schematic content via the API

Why did you build this?

Almost all web systems send emails, whether it be automated reports, transactional emails, or promotional messages. Often times these messages need to be functionally tested as part of the QA process. We found that it was prohibitively difficult to check the contents of an email, so we built Mapil.