> ## Documentation Index
> Fetch the complete documentation index at: https://docs.swashmo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Import from Microsoft 365

> Import your people from Microsoft 365 (Microsoft Entra ID) and keep their details in sync every night.

Swashmo can read your organization's users from Microsoft 365 (Microsoft Entra ID, the directory
behind Outlook and Microsoft Teams), add them to **People**, and keep their details up to date
every night. It's included in the early-access [Free plan](https://docs.swashmo.com/early-access.md) and every plan with the people directory.

## Before you start

* You need to be an **owner or admin** of your Swashmo workspace.
* In Microsoft 365 you need to sign in as a **Global Administrator** or **Privileged Role
  Administrator**: only they can approve an app for the whole organization.

## Connect

1. In Swashmo, open **Settings → Microsoft 365** and click **Connect Microsoft 365**.
2. Microsoft asks you to sign in and shows the permission Swashmo asks for: **Read all users'
   full profiles** (`User.Read.All`). Check **Consent on behalf of your organization** if it is
   shown, then click **Accept**.
3. You come back to Swashmo, which shows **Connected** and your tenant ID. The first import starts
   straight away and takes a minute or two.

To import only some people, enter a group's **object ID** (Microsoft Entra admin center →
Groups → the group → Object ID) under **Only this group** and save. Members of nested groups
are included. Leave it empty to import every enabled user.

## What Swashmo reads, and what it doesn't

For each enabled user (or each member of the group you chose):

* name, email address, job title, department, business and mobile phone, office location;
* their profile photo, if they have one.

Swashmo does not read mail, calendars, files, Teams messages or passwords, and writes nothing to
Microsoft 365.

Left out: guest users, disabled accounts (meeting rooms and equipment are disabled accounts in
Microsoft 365) and accounts without an email address.

## How syncing works

* **Every night** Swashmo reads the changes since the last sync. **Sync now** in Settings runs
  one at once, and **People → Import from Microsoft 365** reads everyone again.
* People are matched by their Microsoft 365 user, then by email. Someone you added by hand or
  from a CSV with the same email is linked, not duplicated.
* Changed details update the person, and their signature is updated (and pushed to Gmail if
  you [use that](https://docs.swashmo.com/admins/push-to-gmail.md)).
* Departments are created as needed.
* Users disabled or deleted in Microsoft 365 are **turned off** in Swashmo, which frees their
  seat. Their links keep working.
* People you turn off in Swashmo stay off. Syncing never turns them back on.
* **Seats:** new people are added only while your plan has seats. When seats run out, Swashmo
  says so and lists who was left out; deactivate people you don't need or [contact us](https://swashmo.com/pricing/#contact) about more seats, then sync again.

Each sync is recorded in **Settings → Security → Audit log**, and the last result (added,
updated, turned off, skipped) is shown in **Settings → Microsoft 365**.

## Disconnect

1. In **Settings → Microsoft 365**, click **Disconnect**. Syncing stops at once. People already
   imported stay in your directory; turn them off or remove them in **People** if you want.
2. To remove Swashmo's access from Microsoft 365 too, open **Microsoft Entra admin center →
   Enterprise applications → Swashmo → Properties → Delete**.

## Troubleshooting

| You see | What to do |
| - | - |
| "Microsoft didn't grant access" | Sign in as a Global Administrator or Privileged Role Administrator, and accept for the whole organization. |
| "That consent link expired or was started by someone else" | Click **Connect Microsoft 365** again and finish within 10 minutes, in the same browser and workspace. |
| **Needs attention** with a message from Microsoft | Access was probably removed in Entra. Click **Connect again**. |
| "Your seats ran out" | Free up seats (or [ask us](https://swashmo.com/pricing/#contact) for more), then **Sync now**. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.