PO6 Mailbox

List all mailboxes the API key has access to, with basic stats for each

Get detailed statistics for a specific mailbox including email counts, storage usage, and folder breakdown

List emails in a mailbox with optional filtering. Returns email metadata without full content.

Get the full content of a specific email including body text, HTML, headers, and attachment metadata. To mark the email as read, use mark_email separately.

Search emails across one or all accessible mailboxes using text search

Mark an email as read/unread or starred/unstarred

Move an email to a different folder

Permanently delete an email. This action cannot be undone. Consider moving to trash first. Requires a two-step confirmation: first call returns a confirmation_token, second call with the token performs the deletion.

List all folders in a mailbox including system folders and custom folders

List all email contact lists for the user. Email lists help organize contacts for outreach campaigns and bulk operations. Requires a paid plan (Standard or Plus).

Get contacts from a specific email list. Returns contact details including email, name, company, and status. Only active contacts can receive emails.

Compose and send a new email to one or more recipients. Requires a paid plan (Standard or Plus). Rate limits vary by plan (Standard: 30/hr, 200/day; Plus: 60/hr, 500/day).

Reply to an email. The reply will be sent from the mailbox's email address to the original sender. Rate limited per plan (Standard: 30/hr, Plus: 60/hr).

Forward an email to one or more recipients. The forward will be sent from the mailbox's email address. Rate limited per plan (Standard: 30/hr, Plus: 60/hr). Max recipients per plan (Standard: 5, Plus: 10).

List email templates available for composing emails. Templates contain pre-written subject and body content with optional variables like {{first_name}} that can be filled in.

Get the full content of an email template including subject, body, and variables.

Create a draft email for the user to review and approve before sending. This is the preferred way for AI agents to compose emails - the user can review, edit, and approve drafts from the web dashboard. Drafts expire after 72 hours if not acted on. Rate limited per plan.

List draft emails pending review. Shows drafts created by AI agents that the user can approve or reject.

List emails sent from a mailbox. Shows all sent emails whether sent by the user (web), AI agent (MCP), or API. Includes delivery status and sent_via source.

List all @po6.com forwarding aliases owned by the user. Returns alias address, forwarding destination, subscription plan, active status, and plus addressing settings.

Get detailed information about a specific @po6.com alias including forwarding destination, verification status, subscription plan, plus addressing, and URL redirect settings.

Update a @po6.com alias settings. Can change forwarding address (triggers re-verification), toggle active status, or configure plus addressing. Cannot create or delete aliases.

List all custom (BYOD) domains owned by the user. Returns domain name, verification status, catchall config, alias count, and BYOD subscription plan with limits.

Get detailed information about a custom domain including verification status, MX records, catchall configuration, aliases, and BYOD plan limits.

Update a domain alias settings. Can change forwarding address (triggers re-verification), toggle active status (subject to plan limits), or configure plus addressing.

Enable, disable, or update the catchall configuration for a custom domain. Catchall forwards all unmatched emails to a specified address. Changing the forward address requires re-verification.

List available landing page templates. Returns template summaries including name, category, and preview information.

Get full details of a landing page template by ID, including widget configuration and default content.

List the user's landing pages with optional filtering by status. Returns page summaries including title, status, URL, and last modified date.

Get a landing page's full details including widget configuration, SEO settings, linked alias/domain, and publication status.

Get analytics and statistics for a landing page including page views, unique visitors, and lead conversion metrics.

List leads/form submissions captured by landing pages. Returns lead details including email, name, submission date, and source page.

Create a new landing page from a template. The page is created in draft status. Optionally link it to a po6 alias or BYOD domain alias for URL routing.

Update a landing page's configuration, title, or SEO settings. Pass the full widget config JSON to update the page layout and content.

Publish a landing page, making it publicly accessible at its URL. Requires a two-step confirmation: first call returns a confirmation_token, second call with the token performs the publish.

Unpublish a landing page, removing it from public access. The page returns to draft status. Requires a two-step confirmation: first call returns a confirmation_token, second call with the token performs the unpublish.

Assign a custom domain to a landing page so it can be accessed via that domain. Requires a two-step confirmation: first call returns a confirmation_token, second call with the token performs the assignment.

Archive (soft-delete) a landing page. If the page is published, it will be unpublished first. Requires a two-step confirmation: first call returns a confirmation_token, second call with the token performs the archive.

Download a published landing page as a standalone HTML file. Returns the full HTML content of the page. The page must be published.