Enabling the Integration

Once you’ve been given access to the integration, we have two routes to authorize Ashby with Microsoft 365; application-wide admin consent and individual consent.

Application-wide admin consent

<aside> 💡 This is the fastest route to get the integration in place for all users. We automatically sync all users of a Microsoft domain if application wide consent has been given.

</aside>

This method allows an admin of both Ashby and an organization's Microsoft tenant to authorize all permissions that Ashby requires for everyone in their organization.

A user from your Microsoft organization with the permission to administer applications should log into Ashby and head to the Integrations page. Microsoft 365 is in the Platform section of the Integrations Marketplace.

To get started, click on Microsoft 365, then Enable Microsoft 365 and then Connect to Microsoft 365.

From there, the admin will be able to confirm the account and review the permissions requested. They can then click Accept to allow Ashby access.

Once accepted, you should see a message confirming that the integration has been enabled.

Admins can also opt to disable the user sync and opt to not automatically enable synced users by unchecking the checkboxes in the General Settings section of the Microsoft integration.

https://cdn.zappy.app/798216f0063b86dbe3a5749ee90b9228.png

https://cdn.zappy.app/118539fe1b8964e5174715347b40f85a.png

https://cdn.zappy.app/5177125806c13a81a9b35b2a855209d2.png

https://cdn.zappy.app/952c092e338f92ae3deffa69b4b5d1bb.png

Individual consent

If you’d prefer user’s to give consent on an individual basis, each user needing access can manage Ashby’s access from their Microsoft 365 Settings (within Personal Settings).

The same permissions as listed above for application-wide admin consent would need to be given. A user can click Connect with Microsoft 365 to connect their account.

https://cdn.zappy.app/52ef06b821616401c029132e5775790c.png

Users will not be synced over automatically via the individual consent route. A user that has been granted the User.Read.All permission in Microsoft can enable user syncing in the Additional Authorization section of the Microsoft 365 integration settings in the Integration Marketplace.

https://cdn.zappy.app/26c8c18f71a8c3ea5eb6ad6bd8f96ba0.png

Users can also individually disable email sync in the Email Setting section of their personal settings at https://app.ashbyhq.com/settings/email.

<aside> 💡

If you have taken the application-wide admin consent route, users will still see To send and receive emails and appointments in Ashby, connect your Microsoft account when navigating to the Microsoft 365 Settings page within Personal Settings.

https://cdn.zappy.app/3cd53d302f02e29dee5a8b44f9484aa4.png

You can review the scopes in the Status section of this page to confirm what is functional and currently syncing.

https://cdn.zappy.app/8aba9d4c9e4366e37da0d2a8d2e4e320.png

Users who are organizing meetings for interviews using Teams, or those looking to schedule interviews to group calendars will need to go through the additional authorizing processes within Microsoft 365 Settings to use these features. This applies even if the application-wide admin consent route has been taken to set up the integration.

</aside>

Microsoft Teams

<aside> 💡 For more information on scheduling via Ashby, check out Scheduling and Interviewing .

</aside>

When scheduling an interview, a meeting can also be automatically scheduled in Teams if you have the Microsoft 365 integration in place and if Microsoft Teams is set as the interview’s location.

https://cdn.zappy.app/0aca360768b14bd23ce1a42ce6975486.png