Creating Microsoft Outlook (Office 365) OAuth App Registration

This guide explains how to create a Microsoft Azure App Registration to allow the website to send emails via Outlook / Office 365 using OAuth.

What This Is For

CourseCo uses Microsoft OAuth to send system emails from your Office 365 mailbox (e.g. training@yourdomain.ie) in a secure, Microsoft-approved way.

What You’ll Need

• Access to Microsoft Entra Admin Center (Azure Portal)

• Global Admin or Application Admin permissions

• The email address you want CourseCo to send emails from eg training@yourcompanyname.com

Step 1: Create a New App Registration

1. Log in to the Microsoft Entra Admin Center

2. Go to Applications → App registrations

3. Click New registration

4. Enter the following:

   • Name: CourseCo Email Integration (or similar)

   • Supported account type:
     Accounts in this organisational directory only (Single tenant)

   • Redirect URI (Web): (edit with your courseco domain)

     CODE

     https://yourdomain.courseco.co/admin/messaging/oauth_set
     

     (Use the exact URL provided by CourseCo)

5. Click Register

Step 2: Note the Application (Client) ID and Tenant ID

Once the app is created:

• Copy and save:

  • Application (Client) ID

  • Directory (Tenant) ID

These will be added to CourseCo Oauth settings

Step 3: Create a Client Secret

1. In the app menu, go to Certificates & secrets

2. Click New client secret

3. Enter:

   • Description: CourseCo Email

   • Expiry: Choose your preferred duration (e.g. 12 or 24 months)

4. Click Add

5. Immediately copy the secret value
   ⚠️ This will only be shown once.

Step 4: Configure API Permissions

1. Go to API permissions

2. Click Add a permission

3. Select Microsoft Graph

4. Choose Application permissions

5. Add the following permissions:

   • Mail.Send

6. Click Add permissions

7. Click Grant admin consent for your organisation

Step 5: Log into CourseCo (admin)

Once logged in as admin

1. Open messaging

2. The small icons between the left menu and the main page, scan down to the last one ‘SMTP Oauth Setup’

   

3. Provider - Select Azure

4. Enter the Client ID, Client Secret, Tenant ID

5. Select Continue

6. 

   Once you select ‘Continue’ you will be redirected to Microsoft and must enter the email and password of your email account

7. You’ve now connected the account, step 6 is the important last step.

Step 6: Grant CourseCo Access in the Admin Console

An administrator must approve CourseCo’s permission request to allow email sending.

1. Log in to the Microsoft Entra Admin Center as a Global Administrator.

2. Navigate to Identity → Applications → Enterprise applications.

3. Locate and select the CourseCo application.

4. Open the Permissions section.

5. Review the requested permissions and click Grant admin consent.

6. Confirm the action when prompted.

Result:
Permissions will show as Granted, and CourseCo will be authorised to send emails on behalf of your organisation.

Step 7: Send yourself an email using CourseCo quick messaging

Once Step 6 is completed, log into CourseCo and send yourself a test email.

User guide here for sending an adhoc message to anyone in your contacts

Support

If your IT team has questions during setup, they can contact CourseCo and we’ll assist directly.