How to connect Microsoft Bookings to Composio

3 min read

Composio connects AI agents to Microsoft Bookings so they can work with booking businesses, appointments, and scheduling data. Access is limited by the permissions you approve and your account’s existing access.

This guide shows you how to set up OAuth credentials and connect Microsoft Bookings to Composio.

Part 1: Create your Microsoft Entra OAuth app

Step 1: Register the app

1. Open Azure portal → App registrations → New registration. Name your app and choose the organizational accounts you want to support.

2. Select Web, enter this redirect URI and click Register.

https://backend.composio.dev/api/v1/auth-apps/add

App registration with the original Composio callback

Step 2: Copy your client ID and create a secret

1. Copy the Application (client) ID from Overview.

Application overview with private identifiers censored

2. Open Certificates & secrets → New client secret.

New client secret button

3. Enter a description, choose an expiry and click Add.

Client secret description and expiry

4. Copy and securely store the secret Value. Use the Value, not the Secret ID. Rotate it before expiry.

Secret Value and identifiers censored

Step 3: Add Microsoft Graph delegated permissions

1. Open API permissions → Add a permission.

API permissions navigation

2. Select Microsoft Graph.

Microsoft Graph API selection

3. Select Delegated permissions.

Permission reference. For listing booking businesses, the minimum delegated permission is Bookings.Read.All. User.Read supports profile access and offline_access continued access. Appointment changes need additional permissions. Choose for your own workflow; the screenshots are examples. Microsoft permission reference.

Delegated permissions selection

4. Choose the delegated permissions needed for the operations your integration will use.

Bookings.Read.All selected

5. Choose the delegated permissions needed for the operations your integration will use. Then click Add permissions.

Configured Bookings permission

Part 2: Connect Microsoft Bookings in Composio

Step 1: Create an auth config

1. In Composio, open Auth Configs and click Create.

Auth Configs Create button

2. Search for and select Microsoft Bookings.

Microsoft Bookings toolkit picker

3. Enter a config name and click Next.

Bookings configuration name

Step 2: Enter your OAuth credentials

1. Choose OAuth 2.0. Enter your app’s Client id and client-secret Value.

OAuth credential fields left empty for privacy

2. Keep the Redirect URI identical to the registered Web callback. Under Scopes, choose permissions required by your integration and supported by your app registration. Click Create Auth Config.

Original callback and three selected scopes

Step 3: Connect your Microsoft account

1. Open the auth config and click Connect Account.

Bookings Connect Account button

2. Keep Microsoft Tenant as organizations, or enter your tenant ID or verified domain to restrict sign-in. Click Connect Account.

Microsoft Tenant connection field

3. Sign in with a work or school account that has Bookings enabled. Personal Microsoft accounts are not supported.

Microsoft work or school account picker

4. Review the app name and permissions, then click Accept. Your tenant may require administrator approval. Leave organization-wide consent unchecked unless your administrator intends to approve it for the tenant.

Microsoft Bookings permission review

Step 4: Check the connection

1. Return to the auth config’s Accounts tab and confirm the connected account shows Active. Copy the Auth Config ID for your application.

Connected account showing verified Active status

Share