Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Register an OAuth provider

Use the information generated during the Microsoft Azure account configuration to register an application as an OAuth provider.

Before you begin

Role required: admin

Procedure

  1. Navigate to All > System OAuth > Application Registry.

  2. Select New.

  3. On the What kind of OAuth application screen, select Connect to a third-party OAuth Provider.

  4. On the form, fill in the fields.

FieldDescription
NameName to uniquely identify the record.
Client IDApplication ID of the application that you created in Microsoft Azure.
Client SecretThe client secret that you generated when you created the application in Microsoft Azure.Note: When using certificates, the Client Secret is a dummy value.
OAuth API ScriptOAuth API script name. For more information see, OAuth API Script. Note: This field is required only while using certificates.
Default Grant typeClient Credentials
Token URLToken URL that you copied after configuring the Microsoft Azure account.
Redirect URLhttps://<instance>./oauth_redirect.do Note: This URL should be the same as the URL in Microsoft Azure.
  1. Select and hold (or right-click) the form header and select Save.

    An OAuth Entity Profile record is created.

  2. In the OAuth Entity Scopes related list, add scopes to match the permissions that you defined when you configured the application.

  3. Select Insert a new row.

  4. Enter smtp as the name and https://outlook.office365.com/.default as the OAuth scope.

  5. Select and hold (or right-click) the form header and select Save.

  6. In the OAuth Entity Profiles embedded list, select the profile created by default.

  7. In the OAuth Entity Scopes embedded list, add a new row and select the smtp scope.

  8. Select Update.

What to do next

Use the OAuth profile to create an email account with SMTP OAuth2.0. For more information, see Create an email account with SMTP OAuth2.0.

Parent Topic:Sending email using client credential flow