Outlook Calendar
Connect Microsoft Outlook Calendar for scheduling availability and event sync.
Outlook Calendar connects through Microsoft OAuth and supports bidirectional calendar and event sync.
Use Outlook Calendar when Microsoft 365 or Outlook is the calendar source your team relies on for availability and appointment records.
Connect Outlook Calendar
- Open Settings > Apps or the scheduling calendar connection area.
- Choose Outlook Calendar.
- Start the OAuth connection.
- Sign in with the Microsoft account that owns the calendar.
- Approve the requested calendar access.
- Return to Agiled and confirm the connection is active.
What Syncs
- Microsoft calendar lists
- Calendar events
- Availability data used by scheduling
- Appointment event updates where supported
Calendar sync depends on the permissions granted during OAuth and the calendar selected after connection. If a user has several Outlook calendars, confirm which one receives new appointments and which ones block availability.
Before Connecting
- Sign in with the Microsoft account that owns the calendar.
- Confirm the Microsoft tenant allows the requested app permissions.
- Decide which calendar should receive Agiled appointments.
- Confirm event type hosts use the expected Microsoft account.
Also check whether the user has multiple Microsoft accounts in the browser. If the wrong account is already signed in, switch accounts before approving the OAuth request.
Test Calendar Sync
- Connect Outlook Calendar.
- Book a safe test appointment from a public booking page.
- Confirm the appointment appears in Agiled.
- Confirm the event appears in Outlook.
- Review cancellation or reschedule behavior where supported.
Use an event on the Outlook calendar to block time, then open the public booking page and confirm that slot is unavailable. This checks conflict detection, not only event creation.
Also test cancellation or reschedule if your event type allows it. Event creation can work while later updates fail because of permissions or selected calendar settings.
Choose Calendars Carefully
Use one calendar for new Agiled appointments and include the calendars that should block availability. If a private calendar contains busy time, make sure it is included for conflict checking when appropriate.
Do not use a teammate's personal calendar for a shared booking page unless that person is the real host.
If several hosts are assigned to event types, each host should connect and test their own Outlook account. One working Microsoft connection does not prove the whole team's availability is accurate.
Troubleshooting
- If OAuth fails, ask a Microsoft 365 admin to check consent policies.
- If events are missing, verify the connected account and calendar ownership.
- If availability is wrong, check Outlook conflicts, Agiled availability, buffers, and booking notice rules.
If the Microsoft account belongs to a managed tenant, admin consent, conditional access, or mailbox policy can affect connection behavior. Ask the tenant admin to review app access if normal OAuth retry does not work.
If bookings appear in Agiled but not Outlook, reconnect the account and confirm the selected destination calendar. If Outlook busy time does not block slots, review the calendars used for conflict checking.
Outlook Calendar Checklist
Before sharing booking links:
- confirm Microsoft tenant and account
- confirm destination calendar
- confirm calendars that block availability
- book one test appointment
- create one busy event and confirm it blocks a slot
- test reschedule or cancellation when supported