Create an Inbox

Use dispatch inbox create when you want a new hosted inbox address. The first run creates a workspace, creates the inbox, saves a workspace key, saves an inbox key, and selects that inbox for mail commands.

Create the First Inbox

dispatch inbox create support

If you omit the name, Dispatch generates a safe address:

dispatch inbox create

Expected result:

• workspace id
• inbox id
• inbox address
• saved workspace key
• saved inbox key
• selected inbox id

Use JSON output for scripts:

dispatch --format json inbox create support

Check the Current Inbox

dispatch status

This confirms which inbox follow-up commands will use.

List Inboxes

dispatch inbox ls

This requires workspace-level access. If you only have one inbox, create or claim it first:

dispatch inbox create
dispatch inbox claim --open

Select a Different Inbox

dispatch inbox use <inbox_id>

Selecting an inbox also makes sure the CLI has an inbox key for that inbox.

Create Another Inbox

dispatch inbox create qa-login

If additional capacity is required, the command can fail with a billing or policy error. The happy paths are:

• Complete the Team 1000 upgrade in the web Billing page, then retry.

• Use wallet-backed x402 autopay:

  dispatch inbox create qa-login --swarm --private-key-path ~/.config/dispatch/wallet.key

Read Plans and Usage before adding team capacity.

Key Safety

• Treat workspace and inbox keys like passwords.
• Do not paste keys into issues, chat, screenshots, or git commits.
• Prefer --private-key-path over inline wallet keys so secrets do not land in shell history.
• If a key is exposed, stop using it and create a fresh session from the web app or support flow.

Next Steps

• Claim the inbox into your account with Claim Inbox in Web.
• Read mail with Read and Search Mail.
• Extract codes and links with Extract Codes and Links.