CLI: Email Mailboxes

An email mailbox is an org-owned primitive that stores email threads and messages. Creating one mints an address on valet.run; mail sent to that address lands in the mailbox, and binding an email channel wakes an agent on inbound mail. Mailboxes are named by their address everywhere. Threads and quarantined messages are named by their RFC 5322 Message-ID, accepted with or without the surrounding angle brackets.

List mailboxes

valet emails [--org <org>]

$ valet emails --org acme
Mailboxes in acme org:
ADDRESS                      DISPLAY NAME  CREATED
quiet-meadow-x7k2@valet.run  Docs inbox    2026-07-21T00:00:00Z

Create a mailbox

valet emails create [--name <display-name>] [--local-part <part>] [--org <org>]

The address mints inside the org's namespace. Without --local-part a random local-part is generated. The printed status reports the org email identity's readiness: provisioning (records pending), inbound_ready (receiving; sending pending identity verification), or ready (receiving and sending).

Mailbox info

valet emails info <address>

Threads

valet emails threads <address>
valet emails threads info <message-id>

Lists the threads in a mailbox — each row shows the thread's root Message-ID, subject, message count, and last-message time. Pass a Message-ID to threads info to read a single thread.

Quarantine

valet emails quarantine [<address>]
valet emails quarantine release <message-id>

Lists the org's quarantined inbound messages — the spam folder. Quarantined messages are stored but not delivered to the agent; release one to re-run ingest (the "not spam" button).

Destroy a mailbox

valet emails destroy <address>