Configuring custom email with Microsoft 365

This article describes how to configure sending Vendorlink emails through your own Microsoft 365 Outlook account.

Basically we need to create an app for that in Microsoft Entra (previously Azure AD), and we need to configure Vendorlink to use that app.

Create an Azure AD App with Graph permissions

To allow our app to send e-mails using our user or service account, we need to configure a Microsoft Entra application with the appropriate permissions.

Create a new App Registration

Head over to Microsoft 365 Admin Center (https://admin.microsoft.com/) and create a new App Registration.

• Microsoft 365 Admin Center > Identity (Microsoft Entra) > App registrations > New registration
• Name: Whatever you want.
• Type: Accounts in this organizational directory only (Single tenant)
• Redirect URI: Not required.

Click on Register

Set up the application permissions

From the test app page in the Azure Portal navigate to:

• API permissions > Add a permission
• Microsoft Graph > Application Permissions > Mail.Send > click Add Permission
• If the status column reads “Not granted for …” click the button above the table to grant admin consent.

Your configured permissions should look like this:

Creating a Client ID and a Client Secret

We need to configure the Tenant ID, Client ID and a new secret in Vendorlink. The secret will need to be created first.

From the App details, go to:

• Certificates & Secrets > New client secret
• Copy the secret value and store it in a safe location (you will not be able to copy it again later)

Now copy the Application ID (Client ID) and the Tenant ID for your application. You can find these on the details page of your app.

Configuring ISPnext

In ISPnext, go to [Admin>General Settings>tab: Mail Settings]

There, you can choose Microsoft 365 as the External mail type, and then fill out the necessary fields:

• Tenant ID
• Application Client ID
• Application Secret - this will be saved when you fill it, but you cannot read it back, for security reasons
• 'From' address - The mail address we should use to send mail from

This configuration needs to be done in conjunction with your Internal IT department.
ISPnext can not assist with filling in these fields or figuring out which values are needed.

In case the secret is no longer valid, you need to fill in the new secret in the corresponding field to update the configuration.

You can use the Send test email button to test your settings.

When the test is successful, you can contact our support via a ticket to turn on the
'Microsoft 365 Enabled ' checkbox.