Disposable Temp Mail API - SnapInbox

Visit SnapInbox Website

Overview

The Disposable Temporary Email API is a super easy-to-use tool that lets you create temporary email addresses for quick and secure tasks. These emails automatically delete themselves after a short time, so there’s no need to clean them up.

It’s perfect for protecting your privacy, avoiding spam, and handling one-time activities like sign-ups or email verifications. Whether you know it as tempmail, 10minutemail, or throwaway email, this API is a hassle-free way for developers to add temporary email features to their apps or services effortlessly.

Features

• Generate a random temporary email
• Retrieve emails from an inbox
• Delete all emails from an inbox
• Fetch specific email details
• Delete a specific email
• Retrieve available email domains

How to Use

This Actor accepts JSON input and performs actions based on the specified action type.

Input Schema

The input follows this structure:

{
    "action": "getRandomInbox",
    "email": "example@cloudbinmail.com",
    "messageId": "12345678-1234-1234-1234-123456789abc"
}

Input Fields

• action (required): Specifies the action to perform. Supported values:
  • getRandomInbox: Get a random temporary email.
  • getInboxMessages: Retrieve messages from the specified email inbox.
  • deleteInbox: Delete all messages in the specified inbox.
  • getMessage: Fetch details of a specific message.
  • deleteMessage: Delete a specific message.
  • getDomains: Retrieve a list of available email domains.
• email (optional): Required for actions that involve retrieving or deleting messages.
• messageId (optional): Needed when fetching or deleting a specific email.

Actions and API Usage

1. Get a Random Inbox

Description: Generates a temporary email address with an available domain.

Example Request:

{
    "action": "getRandomInbox"
}

Example Response:

{
    "status": "ok",
    "code": 200,
    "email": "random123@cloudbinmail.com"
}

2. Retrieve Inbox Messages

Description: Fetches all messages received in the specified inbox.

Example Request:

{
    "action": "getInboxMessages",
    "code": 200,
    "email": "example@cloudbinmail.com"
}

Example Response:

{
    "status": "ok",
    "code": 200,
    "msg": "No available emails",
    "total": 0,
    "messages": []
}

3. Delete All Messages in Inbox

Description: Deletes all messages from the specified email inbox.

Example Request:

{
    "action": "deleteInbox",
    "email": "example@cloudbinmail.com"
}

Example Response:

{
    "status": "ok",
    "code": 200,
    "msg": "All messages deleted."
}

4. Get Message Details

Description: Retrieves the content of a specific email message.

Example Request:

{
    "action": "getMessage",
    "messageId": "12345678-1234-1234-1234-123456789abc"
}

Example Response:

{
	"status": "ok",
	"code": 200,
	"message": {
		"uid": "14d4-6550-9668-fe2e241bd288a",
		"recipient": "abc@cloudbinmail.com",
		"sender": "",
		"subject": "",
		"from": {
			"name": "",
			"address": ""
		},
		"msg": {
			"text": "Test first email",
			"text_formatted": "Test first email<br><br>",
			"html": ""
		},
		"date": "2025-02-02T19:01:22.000Z",
		"timestamp": 1738522871
	}
}

5. Delete a Specific Message

Description: Deletes a specific email message using its unique ID.

Example Request:

{
    "action": "deleteMessage",
    "messageId": "12345678-1234-1234-1234-123456789abc"
}

Example Response:

{
    "status": "ok",
    "code": 200,
    "message": "Message deleted"
}

6. Get Available Domains

Description: Retrieves a list of available domains for temporary email addresses.

Example Request:

{
    "action": "getDomains"
}

Example Response:

{
    "status": "ok",
    "code": 200,
    "domains": ["cloudbinmail.com", "", "", ""]
}

Notes

• Ensure the email format is valid before requesting inbox messages.
• Some actions require an email or messageId, so ensure they are provided when necessary.
• email Required for 'getInboxMessages' and 'deleteInbox' actions.
• messageId required for 'getMessage' and 'deleteMessage' actions.