[{"data":1,"prerenderedAt":54},["ShallowReactive",2],{"$f166k25r66t9k":3},{"href":4,"title":5,"description":6,"kind":7,"mark":7,"planned":8,"contributors":9,"provenance":7,"express":10,"bridge":10,"html":11,"headings":12},"\u002Fdocs\u002Femail\u002Fconnect-a-mail-app","Connect a mail app","Read and send your own mail over IMAP and SMTP, with a separate app password for each mail app.",null,true,[],false,"\u003Ch2 id=\"read-and-send-from-a-mail-app\">Read and send from a mail app\u003C\u002Fh2>\n\u003Cp>A person with a mailbox can connect over IMAP and SMTP using the manual server settings on \u003Cstrong>Account\u003C\u002Fstrong>. The app\nreads and sends as you, using the same mailbox as the portal's \u003Cstrong>Inbox\u003C\u002Fstrong>, and has no access to an AI member's mailbox.\nYou can also keep using \u003Ca href=\"\u002Fdocs\u002Femail\u002Fmcp-and-api\">mail over MCP and the API\u003C\u002Fa>.\u003C\u002Fp>\n\u003Cp>Manual IMAP sign-in, SMTP delivery, Sent filing and password revocation have been checked on the live service.\nDevice-specific compatibility checks for Apple Mail, Outlook and Thunderbird are still in progress. Use the manual\nsettings below; automatic discovery and Apple profile installation are not yet verified on those clients.\u003C\u002Fp>\n\u003Ch2 id=\"app-passwords\">App passwords\u003C\u002Fh2>\n\u003Cp>A mail app does not sign in with your Zero Human sign-in. It is given your address and an \u003Cstrong>app password\u003C\u002Fstrong> instead: a\npassword you make for that one app on \u003Cstrong>Account\u003C\u002Fstrong>, under \u003Cstrong>Mail app passwords\u003C\u002Fstrong>, and can take back at any time without\ntouching the others. App passwords are for a person's own mailbox: you need an address in the enterprise first\n(\u003Ca href=\"\u002Fdocs\u002Femail\u002Fperson-mailboxes\">Person mailboxes\u003C\u002Fa>). An AI member's mailbox has none.\u003C\u002Fp>\n\u003Col>\n\u003Cli>\u003Cstrong>Name it\u003C\u002Fstrong> after the app or the device, such as \u003Ccode>MacBook Mail\u003C\u002Fcode> or \u003Ccode>Phone\u003C\u002Fcode>, so you know which one to revoke later.\nA name is 1 to 80 characters.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Choose what it may do.\u003C\u002Fstrong>\n\u003Cul>\n\u003Cli>\u003Cstrong>Read only\u003C\u002Fstrong> (the default): the mail app reads your mailbox, and cannot send.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Read and send\u003C\u002Fstrong>: it also sends from your address, as you, with no approval step.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Create password\u003C\u002Fstrong>, and copy the password. It is shown once: Zero Human keeps only a scrambled form of it that\ncannot be turned back into the password, so it cannot be shown again, by you or by anyone else. If you lose it,\nrevoke it and make another. Until you press \u003Cstrong>Done\u003C\u002Fstrong> under it, no other password can be made, so the one on screen\nis never replaced before you have copied it.\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Cp>The password is six groups of four letters and digits, such as \u003Ccode>abcd-efgh-jkmn-pqrs-tuvw-xyz2\u003C\u002Fcode>. Case, spaces and the\ndashes between the groups do not matter when a mail app sends it.\u003C\u002Fp>\n\u003Cp>The list shows each password's name, what it may do, when it was made and when a mail app last signed in with it, or\n\u003Cstrong>Never used\u003C\u002Fstrong>. You can hold 20 at once; a revoked one does not count.\u003C\u002Fp>\n\u003Ch3 id=\"revoking-one\">Revoking one\u003C\u002Fh3>\n\u003Cp>\u003Cstrong>Revoke\u003C\u002Fstrong> next to a password stops it at once: the next time a mail app signs in with it, it is refused. Nothing else\nchanges, and your other passwords keep working. A password also stops working, for good, when an owner withdraws your\naddress or moves you to another one, and when you leave the enterprise. Giving the address back, or inviting you back,\ndoes not bring an old password back: you make new ones.\u003C\u002Fp>\n\u003Ch3 id=\"repeated-wrong-passwords\">Repeated wrong passwords\u003C\u002Fh3>\n\u003Cp>After 5 wrong passwords in a row for one address, or from one place, the next sign-ins are refused for a while, even\nwith the right password: a minute at first, then twice as long after each further wrong password, up to 15 minutes.\nOnce the wait is over, the right password signs in again and the count starts over. One person's wrong passwords never\nlock another person out of their own mailbox.\u003C\u002Fp>\n\u003Cp>Every refused sign-in at your address shows on \u003Cstrong>Account\u003C\u002Fstrong> under the list: when, why, and which password it was when\nit was one of yours that is revoked. The password that was tried is never kept or shown.\u003C\u002Fp>\n\u003Ch3 id=\"nobody-else\">Nobody else\u003C\u002Fh3>\n\u003Cp>Your app passwords are yours alone. An owner cannot list, make or revoke them, and has no access to your mailbox\nthrough them, any more than through anything else. An enterprise API token, your own token and a connected app cannot\nmake or revoke one either: only you, signed in to the portal.\u003C\u002Fp>\n\u003Ch2 id=\"server-settings\">Server settings\u003C\u002Fh2>\n\u003Cp>Every app asks for the same four things, for receiving (IMAP) and for sending (SMTP). \u003Cstrong>Account\u003C\u002Fstrong> shows the exact\nvalues to copy, next to your app passwords:\u003C\u002Fp>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Setting\u003C\u002Fth>\n\u003Cth>What to enter\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>Host\u003C\u002Ftd>\n\u003Ctd>The incoming and outgoing server names Account shows\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Port\u003C\u002Ftd>\n\u003Ctd>The port Account shows for each\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Security\u003C\u002Ftd>\n\u003Ctd>The encrypted connection Account names for each (SSL\u002FTLS or STARTTLS)\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>User name\u003C\u002Ftd>\n\u003Ctd>Your full email address, such as \u003Ccode>sam@northstar.zerohuman.com\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Password\u003C\u002Ftd>\n\u003Ctd>The app password you made for this app\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Use the same user name and app password for both servers. A read-only password will sign in to IMAP, and be refused\nwhen the mail app sends over SMTP.\u003C\u002Fp>\n\u003Ch2 id=\"apple-mail-on-macos\">Apple Mail on macOS\u003C\u002Fh2>\n\u003Cp>In Mail, choose \u003Cstrong>Mail → Add Account\u003C\u002Fstrong>, then \u003Cstrong>Other Mail Account\u003C\u002Fstrong>. Enter your name, your email address and the app\npassword, then the incoming and outgoing host names, ports and security from \u003Cstrong>Account\u003C\u002Fstrong>, and choose IMAP as the\naccount type.\u003C\u002Fp>\n\u003Ch2 id=\"apple-mail-on-ios\">Apple Mail on iOS\u003C\u002Fh2>\n\u003Cp>In \u003Cstrong>Settings → Mail → Accounts\u003C\u002Fstrong>, choose \u003Cstrong>Add Account → Other → Add Mail Account\u003C\u002Fstrong>. Enter your name, address and app\npassword, choose \u003Cstrong>IMAP\u003C\u002Fstrong>, and fill in the incoming and outgoing servers from \u003Cstrong>Account\u003C\u002Fstrong>, with your full address as\nthe user name for each.\u003C\u002Fp>\n\u003Ch2 id=\"outlook\">Outlook\u003C\u002Fh2>\n\u003Cp>In Outlook, add an account with your email address, open the advanced options to set it up yourself, and choose\n\u003Cstrong>IMAP\u003C\u002Fstrong>. Enter the incoming and outgoing hosts, ports and security from \u003Cstrong>Account\u003C\u002Fstrong>, and the app password as the\npassword for both.\u003C\u002Fp>\n\u003Ch2 id=\"thunderbird\">Thunderbird\u003C\u002Fh2>\n\u003Cp>In Thunderbird, choose \u003Cstrong>New → Existing Mail Account\u003C\u002Fstrong>, enter your name, address and app password, then \u003Cstrong>Configure\nmanually\u003C\u002Fstrong>. Choose IMAP for incoming, and enter the hosts, ports, security and user name from \u003Cstrong>Account\u003C\u002Fstrong> for both\nservers.\u003C\u002Fp>\n\u003Ch2 id=\"the-gmail-app-on-android\">The Gmail app on Android\u003C\u002Fh2>\n\u003Cp>In the Gmail app, choose \u003Cstrong>Add another account → Other\u003C\u002Fstrong>, enter your address, choose \u003Cstrong>Personal (IMAP)\u003C\u002Fstrong>, and enter\nthe app password. Then enter the incoming and outgoing servers, ports and security from \u003Cstrong>Account\u003C\u002Fstrong>.\u003C\u002Fp>\n\u003Ch2 id=\"folders-and-shared-state\">Folders and shared state\u003C\u002Fh2>\n\u003Cp>\u003Cstrong>Inbox\u003C\u002Fstrong>, \u003Cstrong>Sent\u003C\u002Fstrong>, \u003Cstrong>Archive\u003C\u002Fstrong> and \u003Cstrong>Spam\u003C\u002Fstrong> show the same mail as the\nportal. Labels appear as \u003Ccode>Labels\u002F&lt;label&gt;\u003C\u002Fcode>. Moving mail, changing read or flagged state, and renaming or deleting a\nlabel update that same mailbox. Deleting a label keeps its mail; permanently deleting and expunging a message\nremoves the message from every view. Server drafts are outside this feature: keep drafts on the device.\u003C\u002Fp>\n\u003Cp>A sent message has one Sent copy. The server acknowledges the copy a mail app uploads after sending,\nwithout making another. Replies retain their conversation headers. Original incoming MIME and attachments are\npreserved; historical sent messages without original MIME are reconstructed from the stored message and files.\u003C\u002Fp>\n\u003Ch2 id=\"enterprise-access-and-signatures\">Enterprise access and signatures\u003C\u002Fh2>\n\u003Cp>An owner can turn \u003Cstrong>Mail apps\u003C\u002Fstrong> off on the enterprise page. This blocks new passwords, sign-ins and open\nmail-app sessions without deleting mail or passwords. Turning it on restores passwords that are still valid.\u003C\u002Fp>\n\u003Cp>\u003Cstrong>Account\u003C\u002Fstrong> offers a separate choice to add your portal signature to mail-app sends. It starts off. Turn it on\nonly if you want the server to add that address's signature: it does not try to detect a signature already added by\nthe app. Turn off the app's own signature to avoid signing twice.\u003C\u002Fp>\n\u003Cp>Account also offers an Apple Mail setup profile and a QR link to the setup page. Profile installation on Apple devices\nis still being checked; use manual setup if it does not work on your device.\nNeither contains your password. Enter the app password yourself after opening the profile. Use the manual server\nsettings above where automatic account discovery is unavailable.\u003C\u002Fp>\n",[13,17,20,24,27,30,33,36,39,42,45,48,51],{"id":14,"text":15,"level":16,"planned":10},"read-and-send-from-a-mail-app","Read and send from a mail app",2,{"id":18,"text":19,"level":16,"planned":10},"app-passwords","App passwords",{"id":21,"text":22,"level":23,"planned":10},"revoking-one","Revoking one",3,{"id":25,"text":26,"level":23,"planned":10},"repeated-wrong-passwords","Repeated wrong passwords",{"id":28,"text":29,"level":23,"planned":10},"nobody-else","Nobody else",{"id":31,"text":32,"level":16,"planned":10},"server-settings","Server settings",{"id":34,"text":35,"level":16,"planned":10},"apple-mail-on-macos","Apple Mail on macOS",{"id":37,"text":38,"level":16,"planned":10},"apple-mail-on-ios","Apple Mail on iOS",{"id":40,"text":41,"level":16,"planned":10},"outlook","Outlook",{"id":43,"text":44,"level":16,"planned":10},"thunderbird","Thunderbird",{"id":46,"text":47,"level":16,"planned":10},"the-gmail-app-on-android","The Gmail app on Android",{"id":49,"text":50,"level":16,"planned":10},"folders-and-shared-state","Folders and shared state",{"id":52,"text":53,"level":16,"planned":10},"enterprise-access-and-signatures","Enterprise access and signatures",1794928142873]