# Create an Azure App
## Create a New OAuth Application
1. Create a Microsoft Azure account, if you don't already have one.
2. Login to the Microsoft Azure portal here
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.
4. From the left menu, click on **Azure Active Directory.**
*\*\*Note:* **Azure Active Directory** is now called **Microsoft Entra ID**
5. 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.
2. Click on **API Permissions** on the left menu and then click on **Add a permission**.
3. Click on **Microsoft Graph** then click on **Delegated Permissions.**
4. 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*
5. 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**.
5. 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.
6. Scroll down to the **Native Microsoft Authentication** section
7. Paste the client secret value you copied earlier into the **Microsoft Oauth Client Secret** field
8. From your Azure portal, click on **App Registrations**
9. Copy the Application ID of your Azure App
10. Go back to the **Native Microsoft Authentication** section of your Pyas App's Authentication settings
11. Paste your Azure App's Client ID into the **Microsoft Oauth Client ID** field.
12. Add your Azure App's redirect URL into the **Microsoft Callback URL** field.
13. 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](https://docs.microsoft.com/en-us/azure/active-directory/develop/howto-configure-publisher-domain), when you're ready to take your app to production.
