✓ Verified 💻 Development ✓ Enhanced Data

Automated Ai Email Setup

Receive-only email addresses for AI agents via aiemailservice.com.

Rating
4.2 (436 reviews)
Downloads
19,087 downloads
Version
1.0.0

Overview

Receive-only email addresses for AI agents via aiemailservice.com.

Complete Documentation

View Source →

AI Email Service

Free receive-only email addresses for AI agents at aiemailservice.com.

Base URL

text
https://aiemailservice.com

Quick Start

1. Get an API Key

text
POST /v1/api-key/create
Content-Type: application/json

{}

Returns { "api_key": "ak_..." } — save this, it's your only authentication.

2. Create a Mailbox

text
POST /v1/mailbox/create
x-api-key: ak_your_key
Content-Type: application/json

{}

Returns { "mailbox_id": "mbx_...", "email": "[email protected]", "status": "active" }.

Pass { "username": "preferred-name" } to request a specific name (random assigned if omitted).

3. Use the Email

Sign up for any service using the email address. Then read incoming mail via API.

4. Read Messages

text
GET /v1/mailbox/{mailbox_id}/messages
x-api-key: ak_your_key

5. Wait for a Specific Email (Long-Poll)

text
GET /v1/mailbox/{mailbox_id}/wait?timeout=30&[email protected]
x-api-key: ak_your_key

Hangs until a matching message arrives or timeout. Use this instead of polling.

6. Extract Verification Codes

text
GET /v1/mailbox/{mailbox_id}/codes
x-api-key: ak_your_key

Auto-extracts OTP codes, verification codes, and confirmation links.

Authentication

All requests require x-api-key: ak_your_key header (except POST /v1/api-key/create).

Alternative: Authorization: Bearer ak_your_key

All Endpoints

MethodPathAuthDescription
POST/v1/api-key/createNoCreate API key
POST/v1/mailbox/createYesCreate mailbox (up to 5 per key)
GET/v1/mailboxesYesList your mailboxes
GET/v1/mailbox/{id}/statusYesMailbox status
GET/v1/mailbox/{id}/messagesYesList messages (?limit=50&since=ISO)
GET/v1/mailbox/{id}/messages/{msgId}YesFull message (text + HTML)
GET/v1/mailbox/{id}/latestYesMost recent message
GET/v1/mailbox/{id}/waitYesLong-poll for new mail (?timeout=30&from=&subject_contains=)
GET/v1/mailbox/{id}/codesYesAuto-extracted OTP/verification codes
DELETE/v1/mailbox/{id}YesDelete mailbox + messages
GET/v1/username/check/{username}NoCheck custom username availability
GET/v1/ai-promptNoStructured JSON prompt for AI agents

Example: Complete Signup Flow

javascript
// 1. Get API key
const { api_key } = await fetch('https://aiemailservice.com/v1/api-key/create', {
  method: 'POST', headers: { 'Content-Type': 'application/json' }, body: '{}'
}).then(r => r.json());

// 2. Create mailbox
const { mailbox_id, email } = await fetch('https://aiemailservice.com/v1/mailbox/create', {
  method: 'POST',
  headers: { 'x-api-key': api_key, 'Content-Type': 'application/json' },
  body: '{}'
}).then(r => r.json());

// 3. Sign up for a service using `email`
// ... (browser automation, API call, etc.)

// 4. Wait for verification email
const { message } = await fetch(
  `https://aiemailservice.com/v1/mailbox/${mailbox_id}/wait?timeout=30&[email protected]`,
  { headers: { 'x-api-key': api_key } }
).then(r => r.json());

// 5. Get extracted code
const codes = await fetch(
  `https://aiemailservice.com/v1/mailbox/${mailbox_id}/codes`,
  { headers: { 'x-api-key': api_key } }
).then(r => r.json());

console.log('Verification code:', codes[0]?.codes[0]);

Example: cURL

bash
# Create API key
KEY=$(curl -s -X POST https://aiemailservice.com/v1/api-key/create -H 'Content-Type: application/json' -d '{}' | jq -r '.api_key')

# Create mailbox
curl -s -X POST https://aiemailservice.com/v1/mailbox/create \
  -H "x-api-key: $KEY" -H 'Content-Type: application/json' -d '{}'

# Read messages
curl -s https://aiemailservice.com/v1/mailbox/mbx_xxx/messages -H "x-api-key: $KEY"

# Wait for email from specific sender
curl -s "https://aiemailservice.com/v1/mailbox/mbx_xxx/wait?timeout=30&[email protected]" \
  -H "x-api-key: $KEY"

# Get verification codes
curl -s https://aiemailservice.com/v1/mailbox/mbx_xxx/codes -H "x-api-key: $KEY"

Pricing

  • Free: Up to 5 mailboxes per API key. All features included (messages, wait, codes).
  • Custom Username: £99/year to reserve a specific username (e.g., [email protected]). Random usernames are free.

Important Rules

  • Receive-only — no sending capability exists. Do not attempt to send.
  • Up to 5 free mailboxes per API key. Create additional API keys if needed.
  • Rate limit: 60 requests/minute.
  • Message retention: 30 days.
  • Max 100 inbound emails per mailbox per day.
  • Use /wait for long-polling instead of repeatedly hitting /messages.
  • The /codes endpoint handles OTP extraction — prefer it over parsing emails manually.

Installation

Terminal bash 

openclaw install automated-ai-email-setup
Copied!

💻Code Examples

https://aiemailservice.com

httpsaiemailservicecom.txt
## Quick Start

### 1. Get an API Key

{}

.txt
Returns `{ "api_key": "ak_..." }` — save this, it's your only authentication.

### 2. Create a Mailbox

{}

.txt
Returns `{ "mailbox_id": "mbx_...", "email": "[email protected]", "status": "active" }`.

Pass `{ "username": "preferred-name" }` to request a specific name (random assigned if omitted).

### 3. Use the Email

Sign up for any service using the email address. Then read incoming mail via API.

### 4. Read Messages

x-api-key: ak_your_key

x-api-key-akyourkey.txt
Hangs until a matching message arrives or timeout. Use this instead of polling.

### 6. Extract Verification Codes

x-api-key: ak_your_key

x-api-key-akyourkey.txt
Auto-extracts OTP codes, verification codes, and confirmation links.

## Authentication

All requests require `x-api-key: ak_your_key` header (except `POST /v1/api-key/create`).

Alternative: `Authorization: Bearer ak_your_key`

## All Endpoints

| Method | Path | Auth | Description |
|--------|------|------|-------------|
| POST | `/v1/api-key/create` | No | Create API key |
| POST | `/v1/mailbox/create` | Yes | Create mailbox (up to 5 per key) |
| GET | `/v1/mailboxes` | Yes | List your mailboxes |
| GET | `/v1/mailbox/{id}/status` | Yes | Mailbox status |
| GET | `/v1/mailbox/{id}/messages` | Yes | List messages (`?limit=50&since=ISO`) |
| GET | `/v1/mailbox/{id}/messages/{msgId}` | Yes | Full message (text + HTML) |
| GET | `/v1/mailbox/{id}/latest` | Yes | Most recent message |
| GET | `/v1/mailbox/{id}/wait` | Yes | Long-poll for new mail (`?timeout=30&from=&subject_contains=`) |
| GET | `/v1/mailbox/{id}/codes` | Yes | Auto-extracted OTP/verification codes |
| DELETE | `/v1/mailbox/{id}` | Yes | Delete mailbox + messages |
| GET | `/v1/username/check/{username}` | No | Check custom username availability |
| GET | `/v1/ai-prompt` | No | Structured JSON prompt for AI agents |

## Example: Complete Signup Flow
example.txt
POST /v1/api-key/create
Content-Type: application/json

{}
example.txt
POST /v1/mailbox/create
x-api-key: ak_your_key
Content-Type: application/json

{}
example.js
// 1. Get API key
const { api_key } = await fetch('https://aiemailservice.com/v1/api-key/create', {
  method: 'POST', headers: { 'Content-Type': 'application/json' }, body: '{}'
}).then(r => r.json());

// 2. Create mailbox
const { mailbox_id, email } = await fetch('https://aiemailservice.com/v1/mailbox/create', {
  method: 'POST',
  headers: { 'x-api-key': api_key, 'Content-Type': 'application/json' },
  body: '{}'
}).then(r => r.json());

// 3. Sign up for a service using `email`
// ... (browser automation, API call, etc.)

// 4. Wait for verification email
const { message } = await fetch(
  `https://aiemailservice.com/v1/mailbox/${mailbox_id}/wait?timeout=30&[email protected]`,
  { headers: { 'x-api-key': api_key } }
).then(r => r.json());

// 5. Get extracted code
const codes = await fetch(
  `https://aiemailservice.com/v1/mailbox/${mailbox_id}/codes`,
  { headers: { 'x-api-key': api_key } }
).then(r => r.json());

console.log('Verification code:', codes[0]?.codes[0]);
example.sh
# Create API key
KEY=$(curl -s -X POST https://aiemailservice.com/v1/api-key/create -H 'Content-Type: application/json' -d '{}' | jq -r '.api_key')

# Create mailbox
curl -s -X POST https://aiemailservice.com/v1/mailbox/create \
  -H "x-api-key: $KEY" -H 'Content-Type: application/json' -d '{}'

# Read messages
curl -s https://aiemailservice.com/v1/mailbox/mbx_xxx/messages -H "x-api-key: $KEY"

# Wait for email from specific sender
curl -s "https://aiemailservice.com/v1/mailbox/mbx_xxx/wait?timeout=30&[email protected]" \
  -H "x-api-key: $KEY"

# Get verification codes
curl -s https://aiemailservice.com/v1/mailbox/mbx_xxx/codes -H "x-api-key: $KEY"

Tags

#coding_agents-and-ides

Quick Info

Category Development
Model Claude 3.5
Complexity Multi-Agent
Author tcgsync-git
Last Updated 3/10/2026
🚀
Optimized for
Claude 3.5
🧠

Ready to Install?

Get started with this skill in seconds

openclaw install automated-ai-email-setup

Resources

📂
OpenClaw Skills
View on OpenClaw GitHub
→

Related Skills

✓ Verified 💻 Development

4claw

4claw — a moderated imageboard for AI agents.

🧠 Claude-Ready #ai_and-llms
)}
★ 4.4 (118)
↓ 4,990
v1.0.0
✓ Verified 💻 Development

Aap Passport

Agent Attestation Protocol - The Reverse Turing Test.

🧠 Claude-Ready #ai_and-llms
)}
★ 4.3 (89)
↓ 4,621
v1.0.0
✓ Verified 💻 Development

Acestep Lyrics Transcription

Transcribe audio to timestamped lyrics using OpenAI Whisper or ElevenLabs Scribe API.

⚡ GPT-Optimized #ai_and-llms #api #script
)}
★ 3.8 (274)
↓ 17,648
v1.0.0
✓ Verified 💻 Development

Adaptive Suite

A continuously adaptive skill suite that empowers Clawdbot.

🧠 Claude-Ready #ai_and-llms #bot
)}
★ 4.7 (88)
↓ 1,625
v1.0.0