mailbox.bot

Get your agent's managed receiving endpoint when the account has access to managed receiving. For generally available inbound context, use list_inboun

List inbound packages for approved managed receiving/package accounts with optional filters by status, carrier, and date. Returns tracking number, car

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

Get photos for a package with OCR-extracted text and confidence scores. Filter by photo type to get only exterior shots, label closeups, barcode scans

Request a physical action on a package at the facility. Actions include forwarding to another address, shredding, scanning documents, holding for pick

Request document scanning (OCR + structured data extraction) for a package. The facility will scan the document and extract text, addresses, dates, an

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

Add a tag/label to a package for categorization and filtering. Tags are free-form strings. Adding the same tag twice is a no-op.

Add an observation or context note to a package. Notes are visible to the facility operator and the renter. Use for recording decisions, observations,

Create a standing instruction that auto-triggers actions when incoming packages match conditions. Rules run on every new package and execute the speci

Pre-register an expected inbound shipment so it is auto-matched when it arrives at the facility. Optionally specify an action to auto-execute on arriv

Get usage summary and billing events for a time period. Returns itemized events (scans, forwards, mail sends) with costs, plus period totals. Defaults

List the renter’s private inbound forwarding aliases on forward.mailbox.bot. These are the unique intake email addresses an operator, assistant, provi

List forwarded inbound mail items captured from private forwarding aliases. Default output includes compact draft_context so an LLM or external agent

Get one forwarded inbound mail item with compact draft_context by default. Use this before drafting an outbound reply when you need sender context, re

List physical-mail threads that group inbound mail context, human review, and outbound sends. Use this to understand which inbound items and outbound

Get one physical-mail thread with optional timeline events. Use this to explain how a generated outbound mail piece relates back to prior inbound scan

Push notes, structured data, or a clarification response to an existing action request. Use this to add agent reasoning, attach extracted data, or res