CURL Documentation
Use these CURL commands to interact directly with the Tigrmail API. All requests require authentication via Bearer token.
List Domains
List the inbox domains available for your account.
Example Response
{
"domains": [
"den.tigrmail.com"
]
}Create Inbox
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. It's ok to create a new inbox for each new test run.
Example Response
{
"inbox": "ornery-pixie-bob-f6m0fysfa212cnvr242r@den.tigrmail.com"
}Create Inbox with a Domain
Create an inbox on a specific available domain.
Example Response
{
"inbox": "ornery-pixie-bob-f6m0fysfa212cnvr242r@den.tigrmail.com"
}Customize Your Inbox Email
Enter your inbox email address from the "Create Inbox" response above to automatically update all the polling examples below.
Poll Next Message (Basic)
Poll the next email message for the given inbox. The message gets automatically marked as received and will not be returned in future calls. If no message arrives within 3 minutes, an error will be returned.
Example Response
{
"message": {
"to": [
"ornery-pixie-bob-f6m0fysfa212cnvr242r@den.tigrmail.com"
],
"from": "no-reply@yourapp.com",
"subject": "Verification Code",
"body": "Use this code to confirm your sign-up: 918642"
}
}Poll Message with Subject Filter
Poll for messages with a specific subject (case insensitive match).
Example Response
{
"message": {
"to": [
"ornery-pixie-bob-f6m0fysfa212cnvr242r@den.tigrmail.com"
],
"from": "no-reply@yourapp.com",
"subject": "Verification Code",
"body": "Use this code to confirm your sign-up: 918642"
}
}Poll Message with Subject Contains
Poll for messages that contain a substring in the subject (case insensitive).
Example Response
{
"message": {
"to": [
"ornery-pixie-bob-f6m0fysfa212cnvr242r@den.tigrmail.com"
],
"from": "no-reply@yourapp.com",
"subject": "Verification Code",
"body": "Use this code to confirm your sign-up: 918642"
}
}Poll Message from Specific Email
Poll for messages only from a specified sender email address.
Example Response
{
"message": {
"to": [
"ornery-pixie-bob-f6m0fysfa212cnvr242r@den.tigrmail.com"
],
"from": "no-reply@yourapp.com",
"subject": "Verification Code",
"body": "Use this code to confirm your sign-up: 918642"
}
}Poll Message from Specific Domain
Poll for messages only from a specified sender domain.
Example Response
{
"message": {
"to": [
"ornery-pixie-bob-f6m0fysfa212cnvr242r@den.tigrmail.com"
],
"from": "no-reply@yourapp.com",
"subject": "Verification Code",
"body": "Use this code to confirm your sign-up: 918642"
}
}