K8 HQ

Apple Mail on a Mac

Your email address stays the same. You add it to Mail as a new account.

First, make a token

Each device or app gets its own token, so you can cancel one without affecting the others. Do this once for each one.

  1. Sign in at app.k8hq.com with your passkey.
  2. Open Settings, then Access (under Account). Look for the section called Connect a Mail Client on your Computer or Mobile Device.
  3. Click Make a token. You may be asked to use your passkey again.
  4. Next to What's it for?, choose Mail client (on your computer or phone).
  5. Next to Signs in as, choose your email address. Give the token a Name you will recognize, such as "mail client on my Mac". Leave Expires as it is unless you want the token to stop working on a date.
  6. Click Create token.
  7. Click Copy token right away. You will see it only once. The window also lists your mail server settings, including your organization's mail server name (it looks like abc123.mx.k8hq.net). Keep the window open while you set up your app, or copy the server name somewhere safe. Click Done when you finish.

When the app asks for a password, paste your token. (It's not your K8 HQ sign-in; K8 HQ doesn't use passwords.) Your user name is your full email address.

If you lose a token or can't find the server name, go back to Settings, Access and make a new token. You can revoke old ones in the Your tokens list.

Add the account in Mail

  1. Open Mail. In the menu bar choose Mail, then Add Account.... (If your Mac's Mail has no such item, choose Mail, Settings... (or Preferences...), open the Accounts tab and click the + button at the bottom left.)
  2. Choose Other Mail Account... and click Continue.
  3. Type your name and your full email address. In the password box, paste your token. Click Sign In.
  4. Mail will probably say it can't verify the account and show more boxes. Set Account Type to IMAP. Enter your organization's mail server name for both Incoming Mail Server and Outgoing Mail Server. Make sure the user name is your full email address in both places. Click Sign In.
  5. If Mail asks which apps to use the account with, tick Mail and click Done.

When the app asks for a password, paste your token. (It's not your K8 HQ sign-in; K8 HQ doesn't use passwords.)

The new account appears in Mail's sidebar with its own Inbox, Sent and Trash. Send yourself a test message from it. On a Mac, new mail normally appears within seconds while Mail is open.

Moving older mail

If you have an old account in Mail, you can drag folders from the old account into the new one to copy your old messages across. Keep the old account until you've checked that everything arrived.

The settings, if your app asks

User nameyour full email address
Passwordyour token
Incoming mail server (IMAP)your organization's mail server name, port 993, SSL/TLS
Outgoing mail server (SMTP)the same mail server name, port 587, STARTTLS

Copy the mail server name from the window that appears after you click Create token. Older shared names (imap.k8hq.net for incoming, smtp.k8hq.net for outgoing) still work too, but your own name is the one to use.

If something doesn't work

Back to Help