# Receive Email and Attachments in a Revdoku Mailbox

> Send or forward email to a mailbox's address, then read messages and attachments in the dashboard, API, MCP, or a connected AI app.

Each Revdoku mailbox has an email address. Send or forward a message to that address to store the email and its attachments in the mailbox. The sender does not need a Revdoku account.

## 1. Copy the mailbox's address

Create a mailbox, or open **Mailbox settings → Email** on an existing one. Copy the full address shown there. Check that receiving is ready before asking someone to send mail.

Use the returned address exactly as shown. You do not need to put a mailbox ID in the subject or message body.

## 2. Send a message with an attachment

Send a harmless test message first, with a short subject and a small attachment. Anyone who knows the address can send to it; knowing the address does not grant access to the stored messages.

For example, forward a supplier's quote to the mailbox you use for that project. The mailbox's permissions determine which people and AI agents can read it.

## 3. Read the email and attachment

Open the mailbox's mailbox in the dashboard. You can also read messages through the API, MCP, or a connected AI app.

Accepted messages are saved under `_email/inbox/`, with a separate folder for each delivery:

- `message.eml` preserves the original email.
- `message.json` contains decoded message data.
- `message.md` provides a readable version.
- `attachments/` contains permitted attachment files.

The email stays with its attachments and any reports or notes you save in the mailbox.

## If a message does not arrive

Check the copied address, receiving state, and usage limits. If receiving is paused, resolve the reason shown in the dashboard before sending more mail. Confirm receipt in the mailbox; do not rely on the old email-upload confirmation flow.

For integrations, use the message-list and message-detail operations in the [API reference](/api/). The [email overview](/email/) explains receiving and links to current plans.

Give your AI agent
a free email address

Your AI agent or app gets a unique email address, like myagent@revdokumail.com . It can receive emails and attachments, send replies and store files.

Create your AI agent’s inbox

Connect AI…

Copy this setup prompt and paste it into ChatGPT, Claude or another AI app. It walks you through signup and connecting.

Copy setup prompt

Connect Revdoku so you can create and manage email mailboxes for my AI agents, read emails and attachments, and store files. Follow https://revdoku.com/llms-install.md to set up access.

Developer options
Skill MCP cURL TS/JS Python

npx skills add revdoku/revdoku --skill revdoku -g

For Claude Code, Codex, Cursor and other coding agents.

https://mcp.revdoku.com

Add as a custom connector in Claude, ChatGPT or Cursor. Steps

curl https://api.revdoku.com/v1/mailboxes \
-H "Authorization: Bearer $REVDOKU_API_KEY" \
-H "Content-Type: application/json" \
-d '{"mailbox": {"email": {
"username": "acme-orders",
"domain": "revdokumail.com"}}}'

Creates a mailbox with your API key. API reference

const key = process.env.REVDOKU_API_KEY;
const url = "https://api.revdoku.com/v1/mailboxes";
const res = await fetch(url, {
method: "POST",
headers: {
Authorization: `Bearer ${key}`,
"Content-Type": "application/json",
},
body: JSON.stringify({ mailbox: { email: {
username: "acme-orders",
domain: "revdokumail.com",
} } }),
});
console.log(await res.json());

Creates a mailbox with your API key. API reference

import os, requests
key = os.environ["REVDOKU_API_KEY"]
res = requests.post(
"https://api.revdoku.com/v1/mailboxes",
headers={"Authorization": f"Bearer {key}"},
json={"mailbox": {"email": {
"username": "acme-orders",
"domain": "revdokumail.com",
}}},
timeout=30,
)
print(res.json())

Creates a mailbox with your API key. API reference

AI Agent
Claude Code
ChatGPT

myagent@revdokumail.com

billing@notion.so 9:42 AM

October invoice

Your October invoice for $24.70 is attached.

noreply@github.com 9:38 AM

Your sign-in code

Use 482 916 to sign in to your account.

team@acme.studio Yesterday

Project brief

Hi! Here’s the brief for our next project.

## Frequently Asked Questions

### Does the sender need a Revdoku account?

No. Anyone who knows the bucket's address can send to it. Reading stored messages requires permission to access the bucket.

### Are emails stored along with their attachments?

Yes. Accepted messages are saved as original EML, decoded JSON, readable Markdown, and permitted attachment files.

### How do I choose the destination bucket?

Send to that bucket's full returned address. Do not route messages by putting a bucket ID in the subject or body.

---

[View the canonical page](https://revdoku.com/blog/upload-files-to-a-revdoku-mailbox-by-email/) · [Browse llms.txt](https://revdoku.com/llms.txt)