jamesmcroft / msgraph-meeting-scheduler

Microsoft Graph Meeting Scheduler

This is an experimentation project to understand the capabilities of the Microsoft Graph APIs including user mailboxes, calendars, and how Teams meetings could be scheduled.

The project contains an Azure Functions API that can check calendars of multiple users within a Microsoft 365 tenant based on a period of time, and find availability for the best time for a meeting. The request takes into consideration each participant's schedules, as well as including each individual's time zone to ensure that the times available are most convenient for everyone.

Using the Scheduler API

You will need to create a new Azure AD application and grant it the following application permissions for the Microsoft Graph:

• Calendars.Read
• Mail.Read
• MailboxSettings.Read
• OnlineMeetings.ReadWrite.All
• User.Read.All

Once created, you will need a client secret for the application. This can be generated from the Azure Portal.

Update the local.settings.json file with the following values:

• TenantId: The tenant ID of the Azure AD tenant
• ClientId: The client ID of the Azure AD application
• ClientSecret: The client secret of the Azure AD application

You can then run the project locally using the Azure Functions Core Tools.

Get Availability

To get availability for a meeting, you can make a GET request to the /api/scheduling/availability endpoint with the following query string parameters:

• start: The UTC start date and time to get availability from in ISO 8601 format.
• end: The UTC end date and time to get availability to in ISO 8601 format.
• email: An email address per participant to include in the availability check.
• duration: The expected duration for a meeting in minutes.

For example, to get availability between 1st March 2023 9am until 15th March 2023 5pm, you could make the following request:

/api/scheduling/availability?start=2023-03-01T09:00:00Z&end=2023-03-15T17:00:00Z&email=[e-mail]&email=[e-mail]&duration=60

The response will be a JSON object containing the availability for each participant.

[
  {
    "startTimeUtc": "2023-03-01T16:00:00Z",
    "endTimeUtc": "2023-03-01T17:00:00Z"
  }
]

Supporting this project

As many developers know, projects like this are built in spare time! If you find this project useful, please Star the repo.

Author

👤 James Croft