Help menu Backup, updates & tools

Share read-only mail with a puller, a bot or a buyer

Give someone a link or API key that reads codes from the accounts you pick, and nothing else.

Works in: Windows app6 minUpdated 2026-11-10

A share gives someone read-only mail from the accounts you pick: a puller, your own bots, or the buyer of an account. They can read mail and copy codes. They can't delete, move, reply or send, see passwords, or reach any account outside the share. You can pause or turn it off at any time.

Shares work only while Mailman is open on your computer. The Sharing page names that computer at the top.

Make a share 5 min#

  1. Open Sharing in the left rail (under More on a phone) and select New share.
  2. Pick a preset: Puller, Bot or tool or Buyer. It fills in good defaults that you can change.
  3. Under Who is it for, enter a name. The reader sees it, for example "Jake". Your own note is optional.
  4. Under Which accounts, open the list and pick a tag or group, the accounts selected in Accounts, a pasted list of emails, one account, or all accounts.
  5. Under What they see, choose Codes & links, Codes, tickets & orders or All mail.
  6. Under How they get in, turn on Link, API key or both.
  7. Choose when it ends under Ends, then select Create link, Create API key or Create link & key.

Tags and groups follow changes: an account you tag later joins the share, and one you remove drops out at once. More options sets the senders, how far back they can look, whether they see full emails, the 6-digit PIN and an IP list.

You can start a share from other places too. Select Share next to Filter in the Inbox, Share… in the Accounts selection bar, or Share read-only… from the right-click menu of a group, a tag or accounts. Right-click one account for Share codes read-only…. Settings → Remote access & API has a Read-only sharing card with an Open Sharing button. Remote access and remote keys give full access, so use a share for someone else.

PresetDefault
PullerCodes & links, link with a PIN, last 7 days, ends in 7 days
Bot or toolCodes & links, API key only, last 24 hours, no end
BuyerCodes, tickets & orders, link with a PIN, last 30 days, ends in 3 days

The first share asks once for Your name on shares. It's optional, never your email address, and the reader sees "by" and that name. Select Don't show a name to skip it.

Send it 2 min#

The send screen shows each secret once. Mailman keeps only a fingerprint, so it can't show the PIN, link or key again.

  1. Select Copy beside the link. Send the PIN another way, such as a text.
  2. Or select Copy message and paste it. The message has the link, never the PIN.
  3. For a phone, scan the QR code of the link. The PIN is still asked.
  4. For a bot, copy the API key. It works with the Tasks API, only for the accounts in the share.
  5. Select Done to open the new share.

What the reader sees#

  • The link opens a read-only inbox in any browser, with no account. They paste the account email or alias they're on, and its newest code shows at the top, ready to copy.
  • A code that may have expired shows "Check now". It asks Mailman to look for new mail in that account, at most once a minute.
  • With Show full emails on, they can open a message and read its text. The text is plain and safe, with no scripts or remote images.
  • Five wrong PINs within 15 minutes lock the link for 15 minutes. A new New PIN or New link & PIN gives the real reader a fresh start.
  • They can take a screenshot of what they see. Nothing prevents that, so share with people you trust.

Manage a share#

Select a share in Sharing to open its page. The Active list shows who is viewing now and when each share ends, in amber when that's under two days.

  • Copy link copies the link while this session still has it. Otherwise select New link & PIN, because Mailman can't show an old link again.
  • See what they see opens the reader's page while this session still has the link, and a sample of it otherwise. Edit changes the share and keeps its link, PIN and key.
  • Pause stops it now and Resume turns it back on. Turn off access ends it at once. Select Undo in the message to bring it back.
  • +7 days lengthens a share that ends. Turn on for 7 more days and Turn back on restore an ended or turned-off share.
  • New PIN keeps the link. New link & PIN replaces both. New key replaces the API key.
  • Duplicate for someone else… copies the settings with a blank name.

Activity lists each use for 90 days: who opened, searched or copied what, from which device and IP address. Message text is never logged. To hear about it as it happens, add a Sharing alert in Settings > Alerts: it tells you the first time a share is opened and when its link locks.

API key for bots#

A share's API key is read-only and limited to its accounts. In Only from these IPs, list addresses or ranges such as 34.120.0.0/16 to limit where it works.

A bot can read the newest code for an account, list recent messages, and stream new ones. A bot's tasks can read any text in the mail the share allows, so Show full emails doesn't limit a task. Setup is on the Developers page.

Creating a link needs Remote access on, and a key needs the Tasks API on. The dialog says when one is off and offers to turn it on.

In the web inbox you can see shares and their activity, pause them and turn them off. Making, editing, resuming, extending and renewing them is "Only available in Mailman on your computer".

If it didn't work#

The reader seesDo this
"This link isn't valid."Check they copied all of it, or select New link & PIN.
"Too many wrong PINs."Wait 15 minutes, or select New PIN.
"This share has ended."Select Turn on for 7 more days, or make a new share.
"Access was turned off."Select Turn back on, or make a new share.
"Back soon."Open Mailman on your computer and keep it open. The page tries again by itself.

What's next