This article will walk you through the steps to revoke and reauthorize OAuth access for the Gainsight app.

Connected Apps OAuth Usage

Navigate to Setup > Connected Apps OAuth Usage.

Connected Apps OAuth Usage

Find Gainsight App in the list of connected apps.  Click on the number that shows how many users have authenticated.  This number can be higher than 1 in some cases.

Click the Revoke All button to revoke all OAuth connections for the Gainsight App.


Revoke MDA Authorization from Connectors

Navigate to the Administration > Connectors.

On the Authorize MDA tab, click Revoke. This will fully revoke the MDA authorization and turn off the MDA.

auth revoke.png

Note: If changing OAuth user profile, make sure the new OAuth user has the "Manage Package Licenses" permission enabled in SFDC. For more information, refer to the Gainsight and SFDC Permission Sets article.

OAuth User Permissions

Before reauthorizing MDA, ensure that the OAuth user has the following permissions in Salesforce:

  • Salesforce standard user license and permissions
  • Install Gainsight License
  • Manage package licenses
  • Gainight Admin and the JBCXM Gainsight permissions are enabled
  • API Enabled
  • "Customize Application" setting enabled to create fields on the GS Relationship, Usage Data objects during configurations.

Reauthorize MDA

To reauthorize MDA:

1. Navigate to Administration > MDA Services.

2. Edit the checkboxes under Matrix Data Architecture Settings to uncheck, and then recheck each of them. This will refresh the settings under the new OAuth user.


3. Navigate to Administration > Connectors.

4. Turn the Authorize MDA button to on in order to reauthorize the MDA with the proper user's permissions.

Reauthorize MDA
5. Ensure that the “Authorize” button is selected.  Selecting this will prompt a pop-up that will ask you to allow permission to the Salesforce org. For more information regarding this process, refer to the Authorize Matrix Data Platform (MDA) article.

authorize mda.png

Supplementary Steps

After completing an OAuth reathorization, there are several supplemental steps you can take to refresh functions dependent on OAuth access. These steps are not required to complete an OAuth Authorization, but they ensure each process has been verified to work under the new OAuth user.

  1. Verify OAuth Authorization for the correct user.
  2. Navigate to Administration > Email Configuration and initiate a refresh of the Survey Email Setting by turning it off and back on again. 


  1. Navigate to Administration > Notifications and initiate a refresh of the Notifications service by turning it off and back on again. For more information, refer to the Configuring Email Notifications or My Notification Settings article.
  2. Navigate to Administration > Connectors 2.0 > Salesforce Connector and run each connector as the OAuth user. Ensure that each connector completes successfully and pulls back information. For more information, refer to the Salesforce Connector article.