Tigrmail API allows to create inboxes (email addresses) and use them receive messages in your e2e tests in any programming language of your choice. These can be sign-up emails with a verification link, verification code, or one-time passwords.
\nWe are running a properly configured SMTP server and strive to catch as many emails as possible. Thus, we don't do any spam checks, neither do we check SPF, DKIM, and DMARC records. If your email is sent, it will definitely be delivered to our server so that your e2e tests are as reliable as possible.
\nIt also means that if you want to check deliverability for real-world customers of your app, you need to do it manually when you're configuring your domain for sending emails.
\nIn order to use this API you need to sign up at https://console.tigrmail.com and get an access token.
\nAuthentication is handled through the Authorization header with a Bearer token.
\nResponses for all endpoints are JSON objects, see examples. Endpoints description contain the list of fields that can be returned inside those JSON objects.
\nServer errors are returned with 5xx HTTP code, and we will get immediately notified and start looking into it, but you can reach out to us through live chat at https://tigrmail.com or drop us a letter at support@tigrmail.com.
\nUser errors are returned with 4xx HTTP code and contain human-readable description of what went wrong.
\nAll errors are returned as JSON objects, for example:
\njson
\n{\n \"code\": \"no_message\",\n \"error\": \"no new messages\"\n}\n\nWe provide SDK to ease consuming our API for the following programming languages:
\nIf you've developed an SDK for the other language/framework or want us to develop it so that you could use it, please drop us a note at support@tigrmail.com.
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[{"content":"Overview","slug":"overview"},{"content":"Deliverability","slug":"deliverability"},{"content":"Authentication","slug":"authentication"},{"content":"Response Format","slug":"response-format"},{"content":"Handling Errors","slug":"handling-errors"},{"content":"SDK","slug":"sdk"}],"owner":"15267646","collectionId":"7ca0ca8c-2249-476f-a022-b3c1acd0040f","publishedId":"2sBY4Mtfv6","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-07-14T11:48:17.000Z"},"item":[{"name":"Create Inbox","id":"eb353145-131e-458e-9560-b7265f32cbb4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"url":"https://api.tigrmail.com/v1/inboxes?domain=den.tigrmail.com","description":"Create an inbox (email address) that you can use to send emails to from your app. Only you have access to your inboxes and only you can receive messages from them.
\nIt's ok to create a new inbox for each new test run.
\nResponse fields:
\ninbox: email address to send email to.select special domain for creating inbox
\n","type":"text/plain"},"key":"domain","value":"den.tigrmail.com"}],"variable":[]}},"response":[{"id":"24c799b0-7b9b-4f03-97f2-0bedb20546e3","name":"Create Inbox","originalRequest":{"method":"POST","header":[],"url":{"raw":"https://api.tigrmail.com/v1/inboxes?domain=den.tigrmail.com","protocol":"https","host":["api","tigrmail","com"],"path":["v1","inboxes"],"query":[{"key":"domain","value":"den.tigrmail.com","description":"Choose a domain for the new inbox"}]}},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Tue, 14 Jul 2026 12:54:06 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"58"},{"key":"Connection","value":"keep-alive"},{"key":"X-Ratelimit-Limit","value":"100"},{"key":"X-Ratelimit-Remaining","value":"99"}],"cookie":[],"responseTime":null,"body":"{\n \"inbox\": \"mellow-nap-to7uzino9opn8btogr@den.tigrmail.com\"\n}"}],"_postman_id":"eb353145-131e-458e-9560-b7265f32cbb4"},{"name":"Get available domains","id":"9751ca8f-8fd5-4d1b-a235-62fa055d25ce","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.tigrmail.com/v1/domains","description":"Returns the list of email domains available for inbox creation on the Tigrmail platform.
\nUse this endpoint to discover which domains can be passed as the domain query parameter when calling Create Inbox (POST /v1/inboxes).
Authentication: Bearer token (inherited from collection).
\nResponse
\nA JSON array of domain strings, for example:
\n[\"den.tigrmail.com\", \"tigrmail.com\"]\nEach entry is a fully-qualified domain name that can be used to create inboxes for end-to-end testing.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"(required) Email inbox for polling the new message.
\n","type":"text/plain"},"key":"inbox","value":"ornery-pixie-bob-f6m0fysfa212cnvr242r@den.tigrmail.com"},{"disabled":true,"description":{"content":"Poll message only with precisely specified subject. Case insensitive. Can't be used if subjectContains is specified.
\n","type":"text/plain"},"key":"subjectEquals","value":"Verification Code"},{"disabled":true,"description":{"content":"Poll message that contains provided substring. Case insensitive. Can't be used if subjectEquals is specified.
\n","type":"text/plain"},"key":"subjectContains","value":"Verification"},{"disabled":true,"description":{"content":"Poll messages only from a specified sender.
\n","type":"text/plain"},"key":"fromEmail","value":"user@example.com"},{"disabled":true,"description":{"content":"Poll messages only from a specified domain.
\n","type":"text/plain"},"key":"fromDomain","value":"example.com"}],"variable":[]}},"response":[{"id":"2aed5b98-9bc9-426a-b15f-60fb5a9375b6","name":"Get available domains","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.tigrmail.com/v1/domains","protocol":"https","host":["api","tigrmail","com"],"path":["v1","domains"],"query":[{"key":"inbox","value":"ornery-pixie-bob-f6m0fysfa212cnvr242r@den.tigrmail.com","description":"(required) Email inbox for polling the new message.","disabled":true},{"key":"subjectEquals","value":"Verification Code","description":"Poll message only with precisely specified subject. Case insensitive. Can't be used if subjectContains is specified.","disabled":true},{"key":"subjectContains","value":"Verification","description":"Poll message that contains provided substring. Case insensitive. Can't be used if subjectEquals is specified.","disabled":true},{"key":"fromEmail","value":"user@example.com","description":"Poll messages only from a specified sender.","disabled":true},{"key":"fromDomain","value":"example.com","description":"Poll messages only from a specified domain.","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Tue, 14 Jul 2026 12:54:25 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"48"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"domains\": [\n \"den.tigrmail.com\",\n \"den.tigr.chat\"\n ]\n}"}],"_postman_id":"9751ca8f-8fd5-4d1b-a235-62fa055d25ce"},{"name":"Poll next message","id":"966fc285-9ad2-44a7-9bb0-e40da9879eff","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.tigrmail.com/v1/messages?inbox=ornery-pixie-bob-f6m0fysfa212cnvr242r@den.tigrmail.com&subjectEquals=Verification Code&subjectContains=Verification&fromEmail=user@example.com&fromDomain=example.com","description":"Poll the next email message for the given inbox. The message that gets received gets automatically mark as received and will not be returned in future calls.
\nIf the message was already received by Tigrmail before making this call, it will be returned.
\nOtherwise, the call will block until the message gets received by Tigrmail and then be returned.
\nIf no message has arrived within 3 minutes, an error will be returned, see example.
\nResponse fields:
\nto: the list of recipients from the original email.
from: the original sending email address.
subject: email subject from the original email.
body: contents of the email.
If the message is multipart, the attachments will be handled depending on their type. If these are text attachments, they'll be rendered inline inside body. If these are binary attachments, they'll be replaced with enumerated placeholders like: {attachments[0]}.
(required) Email inbox for polling the new message.
\n","type":"text/plain"},"key":"inbox","value":"ornery-pixie-bob-f6m0fysfa212cnvr242r@den.tigrmail.com"},{"description":{"content":"Poll message only with precisely specified subject. Case insensitive. Can't be used if subjectContains is specified.
\n","type":"text/plain"},"key":"subjectEquals","value":"Verification Code"},{"description":{"content":"Poll message that contains provided substring. Case insensitive. Can't be used if subjectEquals is specified.
\n","type":"text/plain"},"key":"subjectContains","value":"Verification"},{"description":{"content":"Poll messages only from a specified sender.
\n","type":"text/plain"},"key":"fromEmail","value":"user@example.com"},{"description":{"content":"Poll messages only from a specified domain.
\n","type":"text/plain"},"key":"fromDomain","value":"example.com"}],"variable":[]}},"response":[{"id":"db375e41-ce43-4505-b884-9ab49a886fcc","name":"Poll next message","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.tigrmail.com/v1/messages?inbox=mellow-nap-to7uzino9opn8btogr@den.tigrmail.com","protocol":"https","host":["api","tigrmail","com"],"path":["v1","messages"],"query":[{"key":"inbox","value":"mellow-nap-to7uzino9opn8btogr@den.tigrmail.com"}]}},"status":"OK","code":200,"_postman_previewlanguage":"","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Tue, 14 Jul 2026 12:55:40 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"176"},{"key":"Connection","value":"keep-alive"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"message\": {\n \"from\": \"team@tigrmail.com\",\n \"subject\": \"hello there!\",\n \"body\": \"I'm a test email!\\r\\n