Skip to main content
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 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).
  • 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 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