Enabling OAuth 2.0 for a mailbox in Email Management

You can set up Email Management to use OAuth 2.0 for connecting to an Outlook or Gmail mailbox.

We presume that you already have an Outlook or Gmail mailbox configured in Email Management. If not, complete the steps in Configuring Email Management.

If you have Microsoft Office 365 credentials cached on the Sage CRM server, you may encounter errors while completing the below steps. To avoid errors, we recommend that you either complete the steps in an incognito tab of your web browser or clear your web browser's cache.

To enable OAuth 2.0 for a mailbox:

  1. Open a web browser on your Sage CRM server and enter the Sage CRM access URL replacing the server name or IP address with localhost.

    For example: http://localhost/crm

  2. Log on to Sage CRM as a system administrator and go to My profile | Administration | Email and Documents | Email Management Server Options.Click the name of the Gmail or Outlook mailbox for which you want to enable OAuth 2.0, and then click Change.
  3. In Use OAuth 2.0 for, select the mailbox type.
  4. Obtain client ID and secret for your mailbox. For details, see:
  5. Return to Email Management Server Options and paste the client ID and secret into OAuth 2.0 client ID and OAuth 2.0 client secret, respectively.
  6. Click Save.

    When prompted, do the following:

    • Sign in to the Microsoft Azure or Google account that owns the mailbox.

      When signing in to the Google account, you may receive a warning that your app isn't verified. If so, click Advanced and select the option to go to your app.

    • Allow the app you've created to access the Microsoft Azure or Google account.