Microsoft OAuth Setup

This guide explains how to create Microsoft OAuth credentials for use with vuMailKit.

Microsoft OAuth is commonly needed for Microsoft 365, Office 365, Outlook.com, Hotmail.com, and Live.com accounts when modern authentication is required.

Before you begin

Make sure you have:

a working vuMailKit installation
access to the Microsoft account or tenant that will own the app registration
permission to create or manage the Microsoft application registration
your vuMailKit project ready for testing

What you will need from Microsoft

For vuMailKit Basic, you will need this Microsoft value:

Microsoft Client ID

Copy that value carefully. You will later place it into the vuMailKit template in quoted form.

Where you enter it in vuMailKit

In your Clarion application, open the:

vuMailKit global template
OAuth Settings tab

Then:

check Enable Microsoft OAuth Support
paste the Microsoft Client ID into the Microsoft Client ID field

Enter it in this format:

'client-string'

Example:

'12345678-90ab-cdef-1234-567890abcdef'

Do not remove the single quotes.

Custom domains and manual Microsoft OAuth setup

Some Microsoft-hosted mailboxes use a custom company domain instead of an address that obviously looks like Microsoft 365 or Outlook.com.

For example, a mailbox such as user@yourcompany.com may still be hosted by Microsoft 365 even though the email address itself does not show that.

In those cases, vuMailKit may not detect from the domain alone that the mailbox should use Microsoft OAuth.

If autodetect does not identify the account as OAuth, but you know the mailbox is hosted by Microsoft 365, use Manual Configuration in the wizard and select the Microsoft OAuth sign-in method.

Typical Microsoft 365 settings are:

Setting	Typical value
Outgoing server	smtp.office365.com
Outgoing port	587
Outgoing security	STARTTLS
Incoming server	outlook.office365.com
Incoming port	993 for IMAP or 995 for POP3
Incoming security	SSL/TLS
Sign-in method	Microsoft Sign-In

Use the mailbox owner’s actual email address as the account name unless your Microsoft 365 environment requires something different.

If your tenant uses non-standard settings, confirm them with the mailbox administrator.

General setup flow

1. Open the Microsoft Entra admin center

Go directly to the Microsoft Entra admin center:

https://entra.microsoft.com/

If you have access to more than one tenant, switch to the correct tenant first.

Then go to:

Entra ID > App registrations > New registration

2. Create a new application registration

Create a new registration for your vuMailKit-based application.

Use a clear name so you can identify it later.

3. Choose the supported account types

Microsoft will ask which types of accounts your registration should support.

Choose the option that matches the accounts your application is expected to work with. This matters because it controls which Microsoft users can complete authorization.

4. Configure the registration for the flow you will use

Set the registration options to match the OAuth flow expected by your vuMailKit-based application.

The exact labels in the Microsoft portal may change over time, but the goal is the same: create the registration so it can be used for the Microsoft OAuth sign-in process your application will invoke.

5. Copy the Microsoft Client ID

Once the registration has been created, copy the Application (client) ID value.

This is the value you place into the Microsoft Client ID field in the vuMailKit template.

Common mistakes

Common setup problems include:

choosing the wrong supported account type
copying the wrong value instead of the Application (client) ID
landing in Enterprise applications instead of App registrations
forgetting to wrap the value in single quotes in the template
enabling Microsoft OAuth support in the template but leaving the Client ID blank
testing with a Microsoft account type that the registration was not configured to support
assuming a custom domain mailbox is not Microsoft-hosted just because the address does not end in an obvious Microsoft domain