Skip to Content
Docs

Microsoft 365

Connect your Outlook mailbox and calendar, export contacts to Outlook, sync users from Microsoft Entra and sign in with your Microsoft account.

XODASH works with Microsoft 365 in four ways: your own Outlook connection (mailbox and calendar), an optional contact export to Outlook, Microsoft Entra user sync for the customer tenants you manage, and Microsoft sign-in through single sign-on.

Connect your Outlook mailbox and calendar

Each person connects their own Microsoft 365 account. With it connected, XODASH can send email from your account, add your email to CRM timelines, notify you of new mail and show your calendar.

Open the Microsoft Outlook card

Choose Marketplace in the sidebar and find Microsoft Outlook.

Choose Connect

Choose Connect. A Microsoft sign-in window opens.

Sign in and approve

Sign in with your work Microsoft 365 account, the same one you use in Outlook. Microsoft shows the application as XODASH - Outlook and asks you to approve it, unless an administrator in your organization already approved it for everyone.

Check the connection

Open Settings → Integrations. Your Outlook connection is listed with its health and last sync, and its own settings below it.

If sign-in asks for admin approval

Some organizations don't let users approve apps themselves. Then a Microsoft 365 administrator approves XODASH - Outlook in the Microsoft Entra admin center, under Enterprise applications, and you connect again.

Choose what XODASH reads

Under your Outlook connection in Settings → Integrations you can turn each part on or off. These are your own settings; they don't change anyone else's connection.

  • Sync email (on by default): XODASH reads your mailbox to add email to CRM timelines and for new-mail notifications. Turning it off hides the mailbox from XODASH and stops new-mail processing, email rules and email logging to the CRM.
  • Sync calendar (on by default): XODASH reads your calendar for the Calendar app, the dashboard calendar and Teams meetings. Turning it off hides the calendar from XODASH.
  • Log email automatically: what XODASH adds to CRM timelines from your mailbox without you pressing Log. Choose Off, Tracked conversations only or All email with known contacts. Email you send from XODASH and email you log yourself are always logged. Your workspace may limit which options you can pick.

Turning a switch off never deletes anything in Outlook.

The same page lists Tracked conversations (replies XODASH logs for you) and Shared mailboxes. Both come from the Outlook add-in; see Outlook add-in.

Export XODASH contacts to Outlook

Sync XODASH contacts to Outlook is off by default. When you turn it on, the contacts you can see in XODASH are copied to a separate Outlook contacts folder named XODash and kept up to date every 15 minutes, so you can find them on your phone or in Outlook.

  • It goes one way only. Your personal Outlook contacts are never imported into XODASH.
  • Turning it off stops the updates and keeps the copies already in Outlook. Email and calendar stay connected.

Meetings from your calendar

When Sync calendar is on, Teams meetings on your calendar appear in XODASH. If you also use Zoom, choose a Default meeting provider in Settings → Integrations, or No default to be asked each time. See Calendar and meetings.

Sync users from Microsoft Entra

For workspaces that manage Microsoft 365 for their clients, Microsoft Entra imports the users of your customers' tenants into People, linked to the right company, and marks people inactive when their accounts are disabled.

Workspace Admins only

Only a workspace Admin can connect, map, sync or change Microsoft Entra. Everyone else can open the page and see its status and history. You need a Microsoft app registration (client ID and secret) and a partner admin sign-in with GDAP access to your customer tenants.

Open Microsoft Entra

Go to Settings → Integrations and choose Set up (or Manage) on the Microsoft Entra row.

Save the app registration

On the Connection tab, enter the application (client) ID and client secret under App registration and choose Save.

Sign in as a partner admin

Under Partner sign-in, choose Connect with Microsoft and sign in with your GDAP partner account. Each customer tenant must also consent to the app.

Map tenants to companies

On the Companies tab, choose Discover tenants. For each tenant, pick its XODASH company, choose Create new company, or Skip tenant. Use Grant admin consent on a tenant that hasn't consented yet.

Run the first sync

Choose Sync now. Results appear on the History tab.

Decide what a sync may change

New people are always created with everything Entra provides. On the Field rules tab you decide what a later sync may overwrite on people already linked: Display name, Email, Phone, Role and UPN, and whether to Mark inactive when disabled.

The Import filter applies to every tenant: Members only skips guest accounts, Licensed users only skips accounts without a Microsoft 365 license, and you can add Exclusion patterns to skip service accounts by name. Disabled accounts and shared mailboxes are always skipped. A tenant can override the filter on the Companies tab.

Schedule and review

  • Sync & schedule turns Automatic sync on or off and sets how often it runs. Pause sync stops scheduled runs; Sync now still works.
  • Review queue lists Entra users whose email matches more than one person in the company. Link the right person, create a new one, or dismiss. Dismissed users are not queued again.

Disconnecting Microsoft Entra keeps the people, links and mappings; syncing stops until you reconnect.

Sign in with Microsoft

Your workspace can let people sign in with their Microsoft work account through single sign-on. A workspace Admin sets it up in Settings → SSO by choosing Configure SSO and Azure AD as the identity provider. The SSO tab shows the addresses to enter in Microsoft and a step-by-step setup guide.

Once SSO is set up, people choose Continue with SSO on the sign-in page. An Admin can turn on Enforce SSO to require it for everyone, admins included. Passkeys still work. See Security and Sign in.

Next steps

On this page