Creating a Web App in Your Azure Portal

Introduction

In order for Gravity SMTP to send messages from your Microsoft 365 / Outlook account, you will need to create an application in Azure Portal and provide the plugin with a token. You must complete this step before configuring the Microsoft 365 / Outlook Integration within Gravity SMTP. This article outlines steps for creating a web app in your Azure Portal.

Prerequisites

  • A Microsoft Azure account with a valid subscription.
  • A Microsoft-based email address with email-sending permissions (Hotmail, Live, Outlook, Microsoft 365).

Step 1: Create an Azure Account

  1. Visit Azure Portal: Open your browser and go to Azure Portal.
  2. Sign In or Create an Account: If you have an existing Microsoft email account, log in with your credentials. If you need to create a new account, sign up for a free Microsoft Azure account here.

Step 2: Create an Application ID

  1. Open Azure Portal: Once logged in, navigate to your Azure Portal if not automatically redirected.
  2. Search for App Registrations: In the search bar at the top of the page, type “App registrations”.
  3. Create a New Registration: Click on “+ New registration” at the top of the App Registrations page.
  4. Fill Out the Registration Form:
    • Name: Enter a name like “Gravity SMTP” for your organization.
    • Supported Account Types: Select “Accounts in any organizational directory and personal Microsoft accounts”. If this option is not available, select “Accounts in any organizational directory (Any Azure AD – Multitenant)”.
    • Redirect URI: For the first dropdown. Set to “Web”. For the second field, copy the value from your Gravity SMTP settings (found under the Outlook / 365 section in the Redirect URI field).
  5. Register the Application: Click “Register” to proceed.
  6. Verify Settings: After registration, go to the “Authentication” tab to double-check the “Supported account types” and “Redirect URI”. Ensure these are correctly configured.

Step 3: Copy Application (Client) ID

  1. Navigate to Overview: After registration, you’ll be redirected to the Overview page.
  2. Copy Application ID: Find and copy your Application (client) ID from the Overview page. You will need this value later for the Gravity SMTP settings in the Application ID field.

Step 4: Create an Application Password

  1. Navigate to Certificates & Secrets: In the left sidebar, click on “Certificates & secrets”.
  2. Create a New Client Secret: Click on “+ New client secret”.
  3. Fill out the form with the following details:
    • Description: Enter a logical name like “app_password”.
    • Expires: Select “365 days (12 months)”.
    • Add: Click the Add button to save the description and expiration
  4. Get Your Application Password:
    • Copy the password from the “Value” column (not the Secret ID column).
    • Store this value securely, as it will not be accessible after you leave the page. You will need this value later for the Gravity SMTP settings in the Client Secret field.