Skip to documentation
Press slash to search. Press Enter to open the first result, or Tab to choose a link.
Sign inGet started
Browse guides

Start hereBeta

Connect your email

Link your own work email, check that it works and see what each label means.

On this page

Before you start

You link your own email on the Connections page. Nobody can do it for you, and linking it sends nothing: sending is off for the whole workspace right now.

If you see Continue with Google

This button appears only after your workspace admin has set up one-click Google sign-in. Until then, use the steps in the next section.

  1. Choose Continue with Google

    It is on the Email card on the Connections page.

  2. Sign in with your work account

    Google opens its own sign-in page, so Orion never sees your Google password.

  3. Allow what it asks for

    Leave every box ticked. Orion needs all of them, and it tells you if one is missing.

If you do not see it

You can link your email by hand with an app password. That is a special password your email provider makes just for Orion. It is not your normal password.

If Continue with Google is there but you would rather not use it, choose Use an app password instead.

  1. Open Set up manually

    On the Email card, open Set up manually and choose Connect with an app password.

  2. Enter your address and provider

    Orion works with Gmail or Google Workspace, iCloud Mail, Fastmail, Zoho Mail and Yahoo Mail.

  3. Make the app password

    Follow the link shown for your provider. Gmail needs 2-Step Verification turned on first. Name the new password Orion, then copy it.

  4. Paste it and check

    Paste it into App password and choose Check and connect. Orion checks that it works before saving anything, and nothing is sent.

Check that it works

Your Email card shows Connected only after a real check passes.

To see it for yourself, choose Send myself a test email. It goes only to your own address. Check connection runs the check again whenever you want.

What Orion can and cannot do with your email

Linking lets Orion send from your address and read your inbox for replies, once those are switched on. Today neither is on. Reply reading is not on yet, and sending stays off for the whole workspace until Orion can reliably read replies. The only email Orion sends is a test you ask for, to yourself.

When sending is on, Orion sends from your address automatically inside strict limits. There is no approval for each message and no manual start. A reply stops outreach to that person on every channel.

Your admin can see your email address, whether it works and your numbers. They cannot see your password or the messages in accounts you link, and they cannot send as you. Anything you paste into a deal, such as a customer email, can be read by that deal’s owner and admins.

What the labels mean

Not connected: you have not linked this account, so Orion cannot use it.

Connected: a real check passed. It does not mean anything has been sent.

Linked: LinkedIn only. Orion knows which LinkedIn is yours and nothing more. LinkedIn messages stay with you.

Renew soon: LinkedIn ends these links on a date. Reconnect before then.

Needs reconnecting: the account stopped working, usually after a password change. Nothing goes out from it until you reconnect it.

You send: if a channel shows this, Orion does not send there. You press Send yourself, in that app.

Change or remove your mailbox

Choose Switch account and link the mailbox you want to use instead. Conversations already under way finish from the old one.

Choose Remove to stop. Orion erases its copy of your sign-in details right away. Your mailbox itself is not touched.

For technical setup: what an admin does once

An admin does this once, so teammates never have to. It happens with each provider and in your workspace’s hosting settings, not on an Orion screen. The exact steps are in docs/CONNECTIONS.md in Orion’s code.

Switching connections on: until this is done, the Connections page says connections are not switched on. It includes requiring authenticator codes at sign-in.

One-click Google: create an OAuth app in Google Cloud for your Google Workspace and add its client ID and secret to the hosting settings. Until then, Continue with Google does not appear. App passwords need no setup.

X and LinkedIn: create a developer app with each provider and add its client ID and secret. Until then, those cards say they are not available yet. X charges for API access, so turning it on is a spending decision.

Start with your own workspace.

Create a free account, upload your data and prepare your next customer conversation. Choose a paid plan when you need it.