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
- In Swashmo, open Settings → Microsoft 365 and click Connect Microsoft 365.
- 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. - You come back to Swashmo, which shows Connected and your tenant ID. The first import starts straight away and takes a minute or two.
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.
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.
Disconnect
- 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.
- To remove Swashmo’s access from Microsoft 365 too, open Microsoft Entra admin center → Enterprise applications → Swashmo → Properties → Delete.