Microsoft 365 / Outlook integration
Connect Outlook calendars on Microsoft 365 so OneATS schedules interviews around real availability and creates events directly on interviewers' Exchange calendars.
Why connect it
Why connect Microsoft 365 / Outlook to OneATS
Live free/busy
Slots are offered only when the whole panel is free in Outlook.
Native Outlook events
Interviews land in Outlook like any meeting, and move when you reschedule.
RSVP sync
Accepts and declines in Outlook update OneATS through Microsoft Graph notifications.
Setup
How to set up Microsoft 365 / Outlook
The steps below match the screens in your OneATS portal.
Keys, provider links and portal locationWhat you need
- A Microsoft 365 admin who can register apps and grant admin consent in Microsoft Entra ID
- Outlook / Microsoft 365 accounts for interviewers
- A OneATS Growth plan or higher
Admin: register an app in Entra ID
In portal.azure.com, go to Microsoft Entra ID → App registrations → New registration (single tenant).
Admin: copy IDs and a secret
Copy the Directory (tenant) ID and Application (client) ID, then create a client secret and copy its Value.
Admin: grant permissions and save
Grant the Microsoft Graph permissions listed in OneATS with admin consent, then enter the IDs and secret in the Microsoft Azure (Entra ID) section.
Settings → Calendar & Video
Interviewers: connect Outlook
Each interviewer selects Outlook or Microsoft 365 and signs in, then sets working hours and limits.
Settings → My Calendar
Keys and links
Keys you need for Microsoft 365 / Outlook and where they go
An admin registers one app in Microsoft Entra ID; then each interviewer signs in with Outlook or Microsoft 365.
- Directory (tenant) IDThe app's Overview page, under Essentials.Field
Directory (Tenant) ID - Application (client) IDThe app's Overview page, next to the tenant ID.Field
Application (Client) ID - Client secret ValueCertificates & secrets → New client secret (e.g. “OneATS Secret”, 24 months). Copy the Value, not the Secret ID: Azure hides it once you leave the page.Field
Client Secret Value - Organizer mailboxThe Microsoft 365 mailbox that should own interview meetings, e.g. hr@yourcompany.com.Field
Default Organizer Mailbox
API permissions → Microsoft Graph → Application permissions
OnlineMeetings.ReadWrite.AllCreate Teams meeting links.Calendars.ReadWriteRead availability and write interview events.Mail.SendOptional: send invites from the organizer mailbox.
https://api.oneats.co/api/v1/calendar/oauth/callback/microsoft- After adding the permissions, select Grant admin consent for your organisation. Without consent, Microsoft blocks OneATS from creating meetings.
- Add the redirect URI under Authentication with the Web platform, exactly as shown, with no trailing slash.
- Client secrets expire. Put the expiry date in your calendar and replace the Value in OneATS before it runs out.
- Interviewers then connect under Settings → My Calendar → Connected Calendars by selecting Outlook or Microsoft 365.
Where it goes in OneATS
- Settings
- Calendar & Video
- Microsoft Azure (Entra ID)
Then select Save Microsoft Settings.
Open this screen in OneATSAdmins only. You'll be asked to sign in.
- Events are created on the interviewer's Exchange calendar through Microsoft Graph.
- OneATS reads busy times only, not the content of personal events.
- The same app registration powers Microsoft Teams meeting links.
Questions
Microsoft 365 / Outlook questions
How long does the admin setup take?
Usually about 30 minutes for someone with Entra ID admin rights.
The secret stopped working.
Client secrets expire. Create a new one in Entra ID and save its Value in Settings → Calendar & Video.
Start hiring better today
Free plan available. No credit card required. Set up in minutes.