Create an Azure App

Below are the steps for creating an Azure App.

Create a New OAuth Application

1. Create a Microsoft Azure account, if you don't already have one. https://azure.microsoft.com/en-us/free/

2. Login to the Microsoft Azure portal here https://portal.azure.com/

3. If you don't already have an active subscription or your account is new, start a new subscription by clicking the Start button under Start with an Azure free trial. Without an active subscription, you won't have access to the resources needed to create your Azure App.

1. From the left menu, click on Azure Active Directory.

   **Note: Azure Active Directory is now called Microsoft Entra ID

1. From the Active Directory menu, click on App Registrations and then click on New Registration

New App Registration

1. Add a name for your application

2. Choose the account types you want to support. If you're not sure which type to choose, click on the Help me choose... link.

3. For Redirect URI, select Web and add the following URI: https://api.pyas.io/oauth/microsoft/callback . We'll add more redirect URIs later.

4. Click on Register

You've now registered your new Azure App. But, we need to configure some things.

Enable APIs for Your App

1. From the App Registrations page, select your app.

1. Click on API Permissions on the left menu and then click on Add a permission.

1. Click on Microsoft Graph then click on Delegated Permissions.

1. Search for and select to following API permissions

   • openid

   • profile

   • offline_access

   • User.Read

   • email

   • Calendars.Read

   • Calendars.ReadBasic

   • Calendars.Read.Shared

   • Calendars.ReadWrite

   • Calendars.ReadWrite.Shared

   • Subscription.Read.All

   • OnlineMeetings.Read - Optional. Select this scope if you plan on adding Microsoft Teams conferencing to events

   • OnlineMeetings.ReadWrite - Optional. Select this scope if you plan on adding Microsoft Teams conferencing to events

2. Click the Add Permissions button.

Update App Branding

1. From your app page, click on Branding & Properties in the left menu.

2. Fill out the form fields for branding (App Name, Logo, Home Page Url, etc..)

3. Click save.

Add More Redirect URIs

1. From your app page, click on Authentication in the left menu.

2. Click the Web dropdown

3. Click Add URI

4. Add https://www.app.pyas.io/org/apps/oauth/microsoft/callback as a redirect URI.

5. Add your own redirect URIs as needed

6. Click Save

Create OAuth Credentials

1. From your app page, select Certificates & Secrets on the left menu

2. Click on New Client Secret.

3. Add a description for your secret and select 24 months as the expiration date.

4. Click Add.

1. Copy the secret value

Add Your Azure App's OAuth Client ID and Client Secret to Pyas

1. Login to your Pyas account

2. Select the Pyas App you will be updating

3. Go to the Pyas App's settings tab

4. Click on Authentication

5. Under Pyas Authentication, toggle the Enable Pyas Auth for Microsoft Accounts switch off. Then, click the Save Pyas Auth Settings button.

1. Scroll down to the Native Microsoft Authentication section

2. Paste the client secret value you copied earlier into the Microsoft Oauth Client Secret field

1. From your Azure portal, click on App Registrations

2. Copy the Application ID of your Azure App

1. Go back to the Native Microsoft Authentication section of your Pyas App's Authentication settings

2. Paste your Azure App's Client ID into the Microsoft Oauth Client ID field.

3. Add your Azure App's redirect URL into the Microsoft Callback URL field.

4. Click Save Microsoft Settings

That's it! You should now be able to use your Azure App with Pyas to add Outlook Calendar integrations into your app.

Note: Microsoft requires apps that access user data to go through a domain verification process, when you're ready to take your app to production.