Microsoft OAuth Setup

Creating a Microsoft Calendar API Client and Obtaining OAuth Credentials

To build a client that interacts with the Microsoft Calendar API and obtain your OAuth Client ID and Secret, follow these steps:

1. Register a new Application in Azure

• Sign into the Microsoft Azure Portal.
• Navigate to "Azure Active Directory" and select "App Registrations".
• Click “New Registration”.
• Enter the application name (user-facing).
• Choose supported account types, e.g., “Accounts in any organizational directory (multi-tenant)” for SaaS apps or limit it to your organization if desired.
• Add a Redirect URI (for web apps, this is where OAuth responses are sent; e.g., https://yourapp.com/auth/callback).
• Click “Register”.

2. Configure API Permissions

• In the app panel, select “API Permissions” > “Add a permission” > “Microsoft Graph”.
• Choose “Delegated” or “Application” permissions depending on your use case.
• For reading/writing calendars: add Calendars.Read, Calendars.ReadWrite, etc.
• Click “Grant admin consent” if required (especially for organizational apps).

3. Obtain Client ID and Secret

• After registration, note the Application (client) ID; this is your OAuth Client ID.
• Go to “Certificates & Secrets” > “New client secret”.
• Add a description and choose an expiration period, then click “Add”.
• Copy and securely store the value (your OAuth Client Secret); it’s only shown once.

4. Add Client ID and Client Secret to Recal

• Go to "OAuth Credentials" in the sidebar and add your Client ID and Client Secret as well as the redirect URL to the Microsoft Card and hit save.