mailbox.bot

Get your agent's real mailing address beta endpoint when the account has explicit beta access: street address + mailbox number for approved accounts.

List inbound mail or packages for approved real mailing address/package beta accounts with optional filters by status, carrier, and date.

Get full package details including photos, tracking events, shipping label data (carrier, addresses, weight), forwarding status, storage location, and action history.

Get photos for a package with OCR-extracted text and confidence scores.

Request a physical action on a package at the facility.

Request document scanning (OCR + structured data extraction) for a package.

Get document scan results including raw OCR text, structured data fields (addresses, dates, amounts), and confidence scores.

Add a tag/label to a package for categorization and filtering.

Add an observation or context note to a package.

Create a standing instruction that auto-triggers actions when incoming packages match conditions.

Pre-register an expected inbound shipment so it is auto-matched when it arrives at the facility.

Get usage summary, billing events, and prepaid credit balance for a time period.

List the renter’s private inbound forwarding aliases on forward.mailbox.bot.

List forwarded inbound mail items captured from private forwarding aliases.

Get one forwarded inbound mail item with compact draft_context by default.

List physical-mail threads that group inbound mail context, human review, and outbound sends.

Get one physical-mail thread with optional timeline events.

Push notes, structured data, or a clarification response to an existing action request.

Get the renter's MAILBOX.md standing instructions for this agent.

Propose changes to the renter's MAILBOX.md instructions with reasoning.

Send a message to the facility operator managing your mailbox.

List your active facility conversations with unread message counts and last message preview.

Read the message thread with a specific facility.

Configure webhook endpoint URL and event subscriptions for real-time notifications.

Submit a document for printing and postal mailing by the facility.

List outbound mail jobs with status tracking.

Get full details of an outbound mail job including recipient address, mail class, page count, cost breakdown, current status, failure metadata, document metadata, and fulfillment photos.

Cancel a queued outbound mail job before facility printing starts.

Create a sandbox outbound mail record without uploading a real document.

Advance a test_mode outbound mail record one lifecycle step and queue the matching webhook.