# Outlook Calendar

To enable Outlook Calendar integration in the platform, you’ll need to create an application in Azure, configure the necessary Microsoft Graph Calendar permissions, and link it with your Microsoft Partner Network (MPN) account to allow users to connect their Outlook calendars.

### Prerequisites

* Access to Microsoft Partner Center.
* An Azure account with permission to register applications.

### Step 1 — Create a Microsoft Partner Network (MPN) Account

MPN account is needed to verify the business and enable Outlook integration for all the users.

Ref: <https://learn.microsoft.com/en-us/partner-center/enroll/mpn-create-a-partner-center-account>

**1. Sign up for Partner Center**

* Go to [Microsoft Partner Center](https://partner.microsoft.com/en-GB/).
* Click **Join now** or **Become a Partner**&#x20;
* Select "Build" option in "How would you like to partner with Microsoft?" question.
* Login with your work account.

**2. Provide Business Details**

* Enter your organization’s legal business details, address, and primary contact details.
* Accept the **Microsoft Partner Agreement**.

**3. Verification Process**

* Once account is successfully created, login to Microsoft Partner Center.
* Go to **Account settings** → **Legal info.**
* Complete **Partner** & **Developer** verification process.
* You’ll receive an email when verification is complete.

**4. Retrieve Your Partner ID**

* After verification, go to **Partner Center** → **Account settings** → **Identifiers**.
* Note down your **Partner ID** — you’ll need it for Azure app association.

### Step 2 — Register Your App in Azure with Multi-Tenant Support

**1. Open Azure App Registrations**

* Sign in to the [Azure Portal](https://portal.azure.com/).
* Search for **App registrations.**&#x20;

  <figure><img src="https://4071226665-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWrI2FzEYZYjAZv9Px2p6%2Fuploads%2Fm8OAUe6dlyycfTC3CIIb%2Fimage.png?alt=media&#x26;token=95ea9bcd-ae46-47a0-8dc1-58e1c7407f3a" alt=""><figcaption></figcaption></figure>
* Click on **New registration**.

**2. Fill in Registration Details**

* **Name**: Your app’s display name (you can provide your whitelabel instance name).
* **Supported account types**: Select **Accounts in any organizational directory (Any Microsoft Entra ID tenant - Multitenant) and personal Microsoft accounts (e.g. Skype, Xbox).**

**3. Redirect URI**

* Select **Web** option in platform&#x20;
* Add **https\://{whitelabel\_instance\_domain\_name}/integrations/outlook/calendar/callback** as redirect URI.

**4. Click Register**

* Note down your **Application (client) ID** and **Directory (tenant) ID** from the Overview page.&#x20;

  <figure><img src="https://4071226665-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWrI2FzEYZYjAZv9Px2p6%2Fuploads%2F8Gyk9uVlONBRD2y2lbvC%2Fimage.png?alt=media&#x26;token=a2a5301b-86b6-4424-8fc5-ba5f0dd8dd26" alt=""><figcaption></figcaption></figure>

### Step 3 — Add Microsoft Graph Calendar Permissions

* Go to **API permissions** → **Add a permission**.
* Select **Microsoft Graph**.
* Choose from **Application permissions**:

  * Calendars.Read
  * Calendars.ReadWrite
  * Calendars.ReadBasic.All

  Choose from **Delegated permissions**:

  * offline\_access
  * User.Read
* Click **Grant admin consent**.&#x20;

  <figure><img src="https://4071226665-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWrI2FzEYZYjAZv9Px2p6%2Fuploads%2Ftx7aglkfrSiTpBi06mqO%2Fimage.png?alt=media&#x26;token=a5d1c2b0-8f7d-4b2b-8030-614b3f6e82fc" alt=""><figcaption></figcaption></figure>

### Step 4 — Associate Your MPN Partner ID

* In Azure portal, open your registered app.
* Go to **Branding & properties**.
* Provide following details,
  * Logo
  * Home page URL
  * Terms of service URL
  * Privacy statement URL
* Scroll to **Publisher verification** → click **Associate Partner ID**.
* Enter your **Partner ID** from Partner Center.
* Save changes.

### Step 5 — Generate Certificate or Client Secret

* Go to your app → **Certificates & secrets**.
* Under **Client secrets**, click **New client secret**.
* Enter a description and choose an expiry period (e.g., 24 months).
* Click **Add**.
* **Copy the secret value immediately** — it’s only shown once.

Share following details with your account manager to enable Outlook Calendar integration.

1. Application (client) ID
2. Directory (tenant) ID
3. Client secret