Skip to main content
Part of the Identity stack: an API-first, plug-and-play inbox layer for your agent’s phone. Mailboxes give your agent an email address for app signups, verification codes, and incoming messages. Use a managed mailbox or connect an inbox you already own.

Get a mailbox

Open the mailboxes section of the dashboard to create an address or connect an existing inbox. For the SDK, set MOBILERUN_API_KEY and check included capacity:
included_only fails if no included slot remains. included uses included capacity when available and otherwise starts paid checkout; rent always starts paid checkout. Paid rentals can incur charges. If a mailbox is still provisioning, retrieve it again; a checkout URL may arrive in a later response. Complete data.checkoutUrl (Python data.checkout_url) before using an awaiting_payment mailbox.

Use it with a phone

Enter the mailbox address into the signup or sign-in screen on your phone. Wait for the OTP when the app sends its verification email. This example uses an existing mailbox and creates nothing:
The wait polls for up to two minutes by default and only considers codes received after the wait starts, unless you pass after. The comparison uses your computer’s clock. The result contains the code, received time, sender, message ID, and confidence. Use the code in the phone’s verification screen.

Read results

Read message summaries, then retrieve a particular message for its full content:

Bring your own inbox

Start a connection and open the returned redirect URL to authorize access in your browser. The API’s provider field selects the supported inbox type; it is not a managed mailbox purchase.

Costs and cancellation

Included capacity comes from your plan; check the dashboard for current paid rental pricing. Cancelling retains existing addresses and messages. Restarting an archived mailbox keeps its address and can use included capacity or require paid checkout. These are separate lifecycle operations:
For a connected external inbox, disconnect the mailbox link instead of cancelling a rental.

API reference

See Mailbox for capacity, checkout, OTP, and lifecycle endpoints.