Receive Email and Attachments in a Revdoku Mailbox

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. The email overview explains receiving and links to current plans.

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"}}}'

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());

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())