Disposable Temp Mail API - SnapInbox

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:

1{
2    "action": "getRandomInbox",
3    "email": "example@cloudbinmail.com",
4    "messageId": "12345678-1234-1234-1234-123456789abc"
5}

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:

1{
2    "action": "getRandomInbox"
3}

Example Response:

1{
2    "status": "ok",
3    "code": 200,
4    "email": "random123@cloudbinmail.com"
5}

2. Retrieve Inbox Messages

Description: Fetches all messages received in the specified inbox.

Example Request:

1{
2    "action": "getInboxMessages",
3    "code": 200,
4    "email": "example@cloudbinmail.com"
5}

Example Response:

1{
2    "status": "ok",
3    "code": 200,
4    "msg": "No available emails",
5    "total": 0,
6    "messages": []
7}

3. Delete All Messages in Inbox

Description: Deletes all messages from the specified email inbox.

Example Request:

1{
2    "action": "deleteInbox",
3    "email": "example@cloudbinmail.com"
4}

Example Response:

1{
2    "status": "ok",
3    "code": 200,
4    "msg": "All messages deleted."
5}

4. Get Message Details

Description: Retrieves the content of a specific email message.

Example Request:

1{
2    "action": "getMessage",
3    "messageId": "12345678-1234-1234-1234-123456789abc"
4}

Example Response:

1{
2	"status": "ok",
3	"code": 200,
4	"message": {
5		"uid": "14d4-6550-9668-fe2e241bd288a",
6		"recipient": "abc@cloudbinmail.com",
7		"sender": "",
8		"subject": "",
9		"from": {
10			"name": "",
11			"address": ""
12		},
13		"msg": {
14			"text": "Test first email",
15			"text_formatted": "Test first email<br><br>",
16			"html": ""
17		},
18		"date": "2025-02-02T19:01:22.000Z",
19		"timestamp": 1738522871
20	}
21}

5. Delete a Specific Message

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

Example Request:

1{
2    "action": "deleteMessage",
3    "messageId": "12345678-1234-1234-1234-123456789abc"
4}

Example Response:

1{
2    "status": "ok",
3    "code": 200,
4    "message": "Message deleted"
5}

6. Get Available Domains

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

Example Request:

1{
2    "action": "getDomains"
3}

Example Response:

1{
2    "status": "ok",
3    "code": 200,
4    "domains": ["cloudbinmail.com", "", "", ""]
5}

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.