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 sent to CourseCo later.

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: Send Details to CourseCo

Please send the following securely to your CourseCo contact:

• Client ID

• Client Secret

• Tenant ID

Once received, CourseCo will complete the connection and confirm when email sending is active.

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.

Support

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