Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.agentpost.email/llms.txt

Use this file to discover all available pages before exploring further.

Each mailbox is a unique, disposable email address tied to your account. You can create as many as you need, view every message that arrives, and delete a mailbox at any time. When you delete a mailbox, all of its messages are permanently removed with it.

​
Address format

Every mailbox on the default AgentPost domain uses a human-readable random address: 
calm.brook-42@agent.agentpost.email
The local part is generated from a curated list of adjectives and nouns followed by a two-digit number. If the generated name is already taken, the system retries automatically. You can also create mailboxes on your own custom domains.

​
Creating a mailbox

1

Open the New Mailbox dialog

Click New Mailbox in the dashboard header or the sidebar. A dialog appears with two options: a one-click random address on the AgentPost domain, or a custom name on one of your verified custom domains.
2

Choose your address type

Select Random address to have a unique address generated for you instantly. If you have verified custom domains, select Custom name to enter a local part (e.g., support) and pick a domain from the dropdown.
3

Copy your address

After creation, you land on a confirmation page showing your new address and a copy-to-clipboard button. Your mailbox is live immediately — email sent to that address starts arriving right away.
There is no limit on the number of mailboxes you can create. Each address is unique across the entire system.

​
Viewing messages

AgentPost gives you two ways to browse your email:

All Messages

The dashboard shows the latest 50 messages across all your mailboxes, sorted by date. Each message card includes the mailbox it arrived in so you always know which address was used.

Individual mailbox

Click any mailbox in the sidebar to see only the messages for that address. Use this view when you’re focused on a specific sign-up flow or test run.
Messages are grouped into conversation threads. Each thread card shows the subject, sender, a relative timestamp, and a 200-character preview of the latest message body. Click a thread to open the full conversation.

​
Message content

When you open a message, AgentPost renders:
  • HTML email in a sandboxed viewer to prevent script execution and style leakage
  • Plain text fallback when no HTML part is present
  • Attachments with download links; image attachments show an inline thumbnail preview
  • Full headers — subject, from, to, CC, BCC, date (in your local timezone)

​
Real-time delivery

New messages appear instantly without refreshing the page. AgentPost uses WebSockets to push a notification to all your connected browser tabs the moment a message is stored. You’ll also see a toast notification with the subject and sender name. If the WebSocket connection is unavailable, your messages are still stored and will appear when you refresh.

​
Deleting a mailbox

To remove a mailbox, open it in the sidebar and select Delete from the mailbox menu. This permanently deletes the mailbox and every message it contains. The sidebar updates immediately and you are returned to the dashboard.
Mailbox deletion is irreversible. All messages inside the mailbox are permanently removed.