Creating the Heroic Inbox Outlook App

The Heroic Inbox plugin requires an Azure app to access Microsoft 365 or Outlook.com inboxes and send and receive mail on behalf of the plugin.

Once the App creation is complete, a Tenant ID, Client ID, and Client Secret will be generated, which can be entered in the Heroic Inbox setup assistant during setting up the mailboxes.

Step 1: Log In to Azure Portal

1. Go to the Azure Portal.
2. Click on View under Manage Microsoft Entra ID.

Step 2: Add Users

1. Navigate to Users.

2. Add the users who will have access to the Microsoft OAuth app.

Step 3: Register a New App

1. Go to App Registrations.
2. Click on New Registration.

3. Enter your desired App Name.
4. Ensure that Multitenant is selected.

Step 4: Configure Authentication

1. Go to Authentication → Add a Platform → Web.

2. In Heroic Inbox, add a new mailbox and select Outlook.

3. Copy the Redirect URI from Heroic Inbox.

4. Paste the Redirect URI into Azure and click Configure.

Step 5: Set API Permissions

1. Navigate to API Permissions.
2. Click on Add a Permission.
3. Select Microsoft Graph.
4. Ensure all required permissions are added.

Step 6: Generate Client Secret

1. Go to Certificates & Secrets → New Client Secret.
2. Select an expiry period for the secret.
3. Click Add.
4. Copy the Secret Key and save it securely before refreshing the page.

Step 7: Retrieve Application and Tenant IDs

1. Return to the Overview section.
2. Copy the Application ID and Tenant ID.

Step 8: Final Configuration in Heroic Inbox

1. Paste the credentials (Application ID, Tenant ID, and Secret Key) into Heroic Inbox.
2. Click Validate → Select Mailbox.
3. Follow the on-screen prompts to complete the setup.