Skip to content
Dispatch Docs
LLM

Claim Inbox in Web

Claiming links a CLI-created inbox to a signed-in Dispatch account. Wallet recovery is a related flow: it restores a browser workspace session from the wallet that funded an inbox, without requiring an email account first. After either flow, the workspace can be managed from Mail Desk, Billing, Settings, and support flows.

Section titled “Create and Open a Claim Link”
Terminal window
dispatch inbox claim --open

The CLI uses the selected inbox. If you need a specific inbox:

Terminal window
dispatch inbox claim <inbox_id> --open

If the browser does not open, copy the link_url from the output and paste it into a browser.

Complete the Web Flow

Section titled “Complete the Web Flow”
  1. Sign in or create a Dispatch account.
  2. Verify your account email if prompted.
  3. Confirm that the inbox address matches the one you intended to link.
  4. Finish the claim.
  5. Open Mail Desk or Billing from the top navigation.

Verify the Claim

Section titled “Verify the Claim”

In the CLI:

Terminal window
dispatch status

In the web app:

  • Mail Desk should show the inbox.
  • Billing should show the workspace plan and entitlements.
  • Settings should show workspace and inbox keys for the connected session.
Section titled “Link an Inbox Created Somewhere Else”

If a teammate or automation already created the inbox, ask them for one of these:

  • a claim link from dispatch inbox claim --open
  • an inbox API key
  • a workspace API key

Use the Dispatch setup page to link an existing inbox. The standard claim path asks for the inbox address and claim token. The API-key path asks for the inbox or workspace key.

Wallet-Paid or x402 Inboxes

Section titled “Wallet-Paid or x402 Inboxes”

If the inbox was funded by an x402 wallet flow, Dispatch can use the funding wallet as an identity proof. The wallet signs a recovery or claim message locally; no private key is sent to Dispatch, and the signature is not an on-chain transaction.

Recover in the Web App

Section titled “Recover in the Web App”

Use this when you want to sign in directly with the wallet that funded the inbox:

  1. Open https://dispatchjoin.com/signup?mode=wallet.
  2. Choose Use wallet.
  3. Select Ethereum or Solana.
  4. Connect the wallet that paid for or verified the x402 transaction.
  5. Sign the wallet recovery message.
  6. If more than one recoverable inbox appears, choose the inbox you want to restore.
  7. Open Mail Desk, Billing, or Settings.

A recovered wallet session receives workspace and inbox access in the browser. It is not an email-account claim; the wallet is the identity proof for the session.

Claim Into a Dispatch Account

Section titled “Claim Into a Dispatch Account”

Use this when you are already signed in with email and want the inbox attached to that Dispatch account:

  1. Sign in to Dispatch.
  2. Choose the existing inbox link path.
  3. Choose x402 claim.
  4. Connect the funding wallet.
  5. Sign the wallet proof message.
  6. Claim the discovered inbox.

If Claim Fails

Section titled “If Claim Fails”
  • Re-run dispatch inbox claim --open; claim links expire.
  • Confirm the selected inbox with dispatch status.
  • Confirm you are signed into the intended web account.
  • If the inbox was wallet-funded, use the same wallet that funded or verified the payment. For browser wallet sign-in, start at https://dispatchjoin.com/signup?mode=wallet.
  • Check Common Issues.