[{"data":1,"prerenderedAt":40},["ShallowReactive",2],{"$f1cghupjzawkae":3},{"href":4,"title":5,"description":6,"kind":7,"mark":7,"planned":8,"contributors":9,"provenance":7,"express":8,"bridge":8,"html":10,"headings":11},"\u002Fdocs\u002Femail\u002Fperson-mailboxes","Person mailboxes","An owner can give any person in the enterprise an address. Its mailbox is that person's alone: they read it, answer it and file it in the portal, from their own agent, or from code, and nothing they send waits for approval.",null,false,[],"\u003Ch2 id=\"giving-and-withdrawing-an-address\">Giving and withdrawing an address\u003C\u002Fh2>\n\u003Cp>An owner gives a person an email address on \u003Cstrong>People\u003C\u002Fstrong>: each person's entry shows their address, or \u003Cstrong>No mailbox\naddress\u003C\u002Fstrong>. \u003Cstrong>Give one\u003C\u002Fstrong> asks for the address, \u003Cstrong>Change\u003C\u002Fstrong> moves them to another, and \u003Cstrong>Withdraw\u003C\u002Fstrong> takes it away. The\naddress has to be on a domain the enterprise receives mail on, its own mail host or an attached domain whose\nownership has checked (\u003Ca href=\"\u002Fdocs\u002Femail\u002Faddresses-and-domains\">Addresses and domains\u003C\u002Fa>), and nobody else in the product can\nalready hold it: not a member, not an extra address, not another person.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Withdrawn, the address is free.\u003C\u002Fstrong> Mail to it stops being delivered, and what was kept stays the person's until\nthe plan's mail retention removes it.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Removing a person\u003C\u002Fstrong> from the enterprise withdraws their address and their extra addresses, and removes their\ncontacts and their signature.\u003C\u002Fli>\n\u003Cli>Until an owner has given you an address, you cannot send.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2 id=\"privacy\">Privacy\u003C\u002Fh2>\n\u003Cp>The mailbox is the person's. Nobody else reads it: not an owner, not a member, not a member's run, and not an API\ntoken, which belongs to the enterprise and to nobody, so it is refused the \u003Ccode>mail\u003C\u002Fcode> scope and the mail routes. A\nperson's contacts and signature are as private as their mail.\u003C\u002Fp>\n\u003Ch2 id=\"extra-addresses\">Extra addresses\u003C\u002Fh2>\n\u003Cp>Under the person's address on \u003Cstrong>People\u003C\u002Fstrong>, an owner adds further addresses that deliver to the same mailbox, as a\nmember's extra addresses do: exact (\u003Ccode>sales@northstar.zerohuman.com\u003C\u002Fcode>), with a plus tag, or a domain's catch-all. Each\nsays whether a reply to mail that arrived at it goes out from it (the default) or from the person's own address. An\naddress somebody else already holds is refused. Each extra address can carry a signature of its own\n(\u003Ca href=\"\u002Fdocs\u002Femail\u002Fwriting-mail\">Writing mail\u003C\u002Fa>).\u003C\u002Fp>\n\u003Cp>Through the API, an owner gives or changes an address with \u003Ccode>PUT \u002Fv1\u002Fusers\u002F:id\u002Fmailbox\u003C\u002Fcode> (\u003Ccode>{ &quot;address&quot;: &quot;…&quot; }\u003C\u002Fcode>) and\nwithdraws it with \u003Ccode>DELETE \u002Fv1\u002Fusers\u002F:id\u002Fmailbox\u003C\u002Fcode>; both answer with the person's row. \u003Ccode>GET \u002Fv1\u002Fusers\u003C\u002Fcode> lists each\nperson's address, and \u003Ccode>GET \u002Fv1\u002Fauth\u002Fme\u003C\u002Fcode> carries your own as \u003Ccode>mailAddress\u003C\u002Fcode>. A person's extra addresses are\n\u003Ccode>GET \u002Fv1\u002Fusers\u002F:id\u002Fmail-aliases\u003C\u002Fcode>, added with \u003Ccode>POST\u003C\u002Fcode> (\u003Ccode>{ &quot;address&quot;: &quot;…&quot;, &quot;replyFromAlias&quot;?: true }\u003C\u002Fcode>), changed with\n\u003Ccode>PATCH \u002Fv1\u002Fusers\u002F:id\u002Fmail-aliases\u002F:aliasId\u003C\u002Fcode> and removed with \u003Ccode>DELETE\u003C\u002Fcode> on the same path. Only an owner, signed in,\ncalls these.\u003C\u002Fp>\n\u003Ch2 id=\"your-own-inbox\">Your own inbox\u003C\u002Fh2>\n\u003Cp>Once you have an address, \u003Cstrong>Inbox\u003C\u002Fstrong> sits under \u003Cstrong>Chat\u003C\u002Fstrong> in the portal's navigation, with a count of the mail you have\nnot opened yet; the enterprise picker shows the same count on each company where you have an address. It is a mailbox\nlike a member's: inbox, one tab per label, the archive and \u003Cstrong>Sent\u003C\u002Fstrong>, each mail opening as its sender laid it out,\nwith its files, the rest of its conversation and its ids, and \u003Cstrong>Open full screen\u003C\u002Fstrong> for a page of its own.\u003C\u002Fp>\n\u003Cp>On a mail: \u003Cstrong>Reply\u003C\u002Fstrong>, \u003Cstrong>Reply all\u003C\u002Fstrong>, \u003Cstrong>Forward\u003C\u002Fstrong>, \u003Cstrong>Archive\u003C\u002Fstrong> or \u003Cstrong>Move to inbox\u003C\u002Fstrong>, \u003Cstrong>Labels\u003C\u002Fstrong>, \u003Cstrong>Snooze\u003C\u002Fstrong>, \u003Cstrong>Move\u003C\u002Fstrong>,\nwhich hands the mail and its conversation to another mailbox in the company, and \u003Cstrong>Delete\u003C\u002Fstrong>, which removes it for\ngood. Above the list, \u003Cstrong>New mail\u003C\u002Fstrong> sends from your address. A reply, forward or new mail can leave from one of your\nextra addresses instead. The inbox takes in a day what your plan allows, as a member's does\n(\u003Ca href=\"\u002Fdocs\u002Femail\u002Fmember-mailboxes#inbound-mail-a-day\">Member mailboxes\u003C\u002Fa>).\u003C\u002Fp>\n\u003Ch2 id=\"reading-and-answering-from-outside-the-portal\">Reading and answering from outside the portal\u003C\u002Fh2>\n\u003Cp>You can read and answer your mailbox as yourself from Claude, ChatGPT or any MCP client, by connecting the\nenterprise's MCP server and choosing what the app may do with \u003Ccode>mail\u003C\u002Fcode> when you connect it, or from code with the API.\n\u003Cstrong>Read\u003C\u002Fstrong> lets the app list and read your mail and its files; \u003Cstrong>Write\u003C\u002Fstrong> lets it reply, forward, send, delete and file.\nSee \u003Ca href=\"\u002Fdocs\u002Femail\u002Fmcp-and-api\">Mail over MCP and the API\u003C\u002Fa>.\u003C\u002Fp>\n\u003Cp>\u003Cstrong>Your own mail needs no approval.\u003C\u002Fstrong> A member's send waits for the owner to approve the exact message; yours leaves in\nthe call that asked for it. The rules every send meets still hold: it goes out only from an address of yours, the\ndomain has to be one Zero Human sends from, and the sent copy is filed in your mailbox, a reply in the thread of the\nmail it answers.\u003C\u002Fp>\n\u003Ch2 id=\"filing-your-mail\">Filing your mail\u003C\u002Fh2>\n\u003Cp>Write access lets an app keep your inbox in order, as a member's triage task keeps a member's:\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Labels\u003C\u002Fstrong> of your own choosing on a message, which the inbox shows as tabs and the list filters by.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>A handled state\u003C\u002Fstrong>: unhandled, replied, skipped, or snoozed until a date and time, after which it is unhandled\nagain. Escalated is a member's state, raised to the owner; your mail has nobody to raise to, so it is refused.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Many at once\u003C\u002Fstrong>: one change on up to 200 messages by id, or on every unhandled message from one sender.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2 id=\"one-click-buttons-on-a-cadence-of-your-own\">One-click buttons, on a cadence of your own\u003C\u002Fh2>\n\u003Cp>A task can declare a button for a mailbox: your inbox offers every such task of the enterprise above its list, or on\neach open mail, and pressing one starts the task over your mailbox. A template in the Catalog that declares a button is\noffered too, and pressing it asks to clone the template first. Beside each button over the whole inbox you pick how\noften it runs for you: \u003Cstrong>By hand\u003C\u002Fstrong>, or a cadence such as \u003Cstrong>Every 15 minutes\u003C\u002Fstrong>, in the enterprise's timezone. Each time\nit comes round the OS presses the button for you, recorded as asked for by you. Nobody else can put your mailbox on a\ncadence.\u003C\u002Fp>\n\u003Ch2 id=\"a-token-of-your-own\">A token of your own\u003C\u002Fh2>\n\u003Cp>For a script, a scheduled job or a client that cannot sign in, \u003Cstrong>Account\u003C\u002Fstrong> issues a token that is yours alone: name it,\nchoose \u003Cstrong>Read\u003C\u002Fstrong> or \u003Cstrong>Read and write\u003C\u002Fstrong>, and copy it once. It reaches your mailbox and nothing else, and stops the moment\nyou revoke it or leave the enterprise. The details are on\n\u003Ca href=\"\u002Fdocs\u002Femail\u002Fmcp-and-api#a-token-of-your-own\">Mail over MCP and the API\u003C\u002Fa>.\u003C\u002Fp>\n\u003Ch2 id=\"mail-app-passwords\">Mail app passwords\u003C\u002Fh2>\n\u003Cp>For a standard mail app, \u003Cstrong>Account\u003C\u002Fstrong> makes app passwords: name one, choose \u003Cstrong>Read only\u003C\u002Fstrong> or \u003Cstrong>Read and send\u003C\u002Fstrong>, and copy\nit once. Nobody but you can list, make or revoke them, an owner included. They stop when you revoke them, when your\naddress is withdrawn or changed, and when you leave the enterprise. Over the API, signed in:\n\u003Ccode>GET \u002Fv1\u002Fmail\u002Fapp-passwords\u003C\u002Fcode>, \u003Ccode>POST \u002Fv1\u002Fmail\u002Fapp-passwords\u003C\u002Fcode> (\u003Ccode>{ &quot;name&quot;: &quot;…&quot;, &quot;scope&quot;: &quot;read&quot; }\u003C\u002Fcode>, or \u003Ccode>&quot;read_send&quot;\u003C\u002Fcode>)\nand \u003Ccode>DELETE \u002Fv1\u002Fmail\u002Fapp-passwords\u002F:id\u003C\u002Fcode>. Signing a mail app in with one, over IMAP and SMTP, is still being built:\n\u003Ca href=\"\u002Fdocs\u002Femail\u002Fconnect-a-mail-app\">Connect a mail app\u003C\u002Fa> explains what is coming.\u003C\u002Fp>\n",[12,16,19,22,25,28,31,34,37],{"id":13,"text":14,"level":15,"planned":8},"giving-and-withdrawing-an-address","Giving and withdrawing an address",2,{"id":17,"text":18,"level":15,"planned":8},"privacy","Privacy",{"id":20,"text":21,"level":15,"planned":8},"extra-addresses","Extra addresses",{"id":23,"text":24,"level":15,"planned":8},"your-own-inbox","Your own inbox",{"id":26,"text":27,"level":15,"planned":8},"reading-and-answering-from-outside-the-portal","Reading and answering from outside the portal",{"id":29,"text":30,"level":15,"planned":8},"filing-your-mail","Filing your mail",{"id":32,"text":33,"level":15,"planned":8},"one-click-buttons-on-a-cadence-of-your-own","One-click buttons, on a cadence of your own",{"id":35,"text":36,"level":15,"planned":8},"a-token-of-your-own","A token of your own",{"id":38,"text":39,"level":15,"planned":8},"mail-app-passwords","Mail app passwords",1794928143048]