Connecting Microsoft 365
Connecting Microsoft 365
Connecting Microsoft 365 gives Codex permission to read and send mail as you, read your calendar, and keep your CRM tasks in Microsoft To Do. You do it once. This lesson walks through the page, the sign-in, and what the page shows when the connection succeeds.
Finding the Microsoft 365 page
The page lives at this address:
https://codex.isidoregroup.net/admin/crm/microsoft-365
You can also reach it three other ways, depending on what is already turned on:
- Sales → Microsoft 365 in the sidebar, once an administrator has turned journeys on. Until then the menu entry is hidden, but the page works by its address for every CRM user.
- The Connect Microsoft 365 link at the bottom of a person’s Email window, once your CRM mailbox is enabled.
- The links in the Work Queue strip, once journeys are on.
A first connection usually goes by the address, because it comes before journeys are on and before your mailbox is enabled. Bookmark it.
What the page shows before you connect
The page is titled Microsoft 365, with the line “Connect your own Microsoft 365 account so Codex can read and send mail, read your calendar, and keep your tasks in Microsoft To Do, as you.” It has three sections:
- Your connection, with a status badge on the right. Before you connect, the badge reads Not connected.
- Journey email, which Lesson 1.6 covers.
- Before you connect, which explains what Microsoft will ask and says that Codex stores the sign-in encrypted and uses it only for your own mailbox.
Connecting, step by step
- Select Connect Microsoft 365 in the Your connection section. If the button is missing and a warning about your Microsoft sign-in shows instead, go back to Lesson 1.2.
- Microsoft opens its sign-in page. Choose your Isidore work account, the same one you sign in to Codex with.
- An administrator has already approved Codex CRM for the whole organization, so Microsoft does not ask you to approve anything. If Microsoft shows an Approval required page instead, stop and ask your administrator (Lesson 1.5).
- Microsoft returns you to the Microsoft 365 page. A green notice titled Microsoft 365 connected reads “Microsoft 365 is connected.”
What the page shows after you connect
The badge now reads Connected in green, and the Your connection section lists:
| Field | What it shows |
|---|---|
| Mailbox | The CRM mailbox Codex holds for you, once one exists |
| Tenant sign-in name | The Microsoft account that connected |
| Connected since | When the connection was made, in your local time |
| Last refresh | The last time Codex renewed the sign-in in the background |
Under What Codex can do for you, the page lists the permissions in plain words:
- Sign you in and read your basic profile
- Read your mail
- Send mail as you
- Read your calendar
- Read and write your tasks in Microsoft To Do
- Stay connected without asking you to sign in again
- Identify your account
That list is the full extent of what the connection allows. Codex uses it only for your own mailbox, calendar, and To Do list.
What changes once you are connected
- Sending. Email you send from a person’s page leaves from your own mailbox and appears in your Sent Items. Before you connect, the CRM cannot send email as you at all.
- Reading. Codex reads your Inbox and Sent Items through your own sign-in and files mail against CRM people (Lesson 3.1).
- Journeys. Automated journey email can leave through your connection once an administrator finishes your journey alias (Lesson 1.6).
- Tasks. Once journeys are on, your CRM tasks appear in a Microsoft To Do list named Codex CRM (Lesson 5.1).
Your CRM mailbox
Connecting does not by itself approve your mailbox for the CRM. If Codex had no CRM mailbox for you, connecting adds one in a disabled state, and an administrator tests access and enables it. Until then, a person’s Email window says:
“Your mailbox is not enabled for the CRM. Ask an administrator to enable it in CRM settings.”
Tell your administrator once you have connected, so the mailbox can be enabled the same day.
What you should remember
- The Microsoft 365 page is at
/admin/crm/microsoft-365, and it works by address before its menu entry appears. - Connect Microsoft 365 opens the Microsoft sign-in. Use your Isidore work account.
- Success shows the notice Microsoft 365 connected and the Connected badge.
- What Codex can do for you lists every permission the connection grants.
- An administrator still enables your CRM mailbox after you connect.
The next lesson reads every status the badge can show and what to do about each one.
