Create an OAuth Integration
To enable OAuth 2.0 authentication, you’ll need to create an integration in Gong.
Log in to Gong
Sign in to your Gong account.
Go to Admin Center
Click on the Admin Center button (gear icon) from the left menu at the bottom.
Navigate to API Page
Under the Ecosystem section, click on the API menu.
Open Integrations Section
Click on the INTEGRATIONS tab to open it.
Create New Integration
Click the Create Integration button to start creating a new OAuth integration.
- Enter a name for your integration (e.g., “StackOne”)
- Add a description for your integration
- Enter a short description for your integration
- Upload an app logo (any square image, e.g., your company logo)
Configure Required Scopes
In the Required authorization scopes section, select the scopes your integration needs.
- api:users:read is required for connection testing
- api:workspaces:read and api:permission-profile:read are needed for roles and groups on users
- Select additional scopes based on your integration needs (e.g., api:calls:read:basic for call data)
Configure Integration Details
Fill in the required integration information.
- Redirect URI: the Callback URL from your Connector Profile
- Privacy Policy URL: Enter a link to your organization’s privacy policy page
- Terms & Conditions URL: Enter a link to your organization’s terms and conditions page
- Help Article URL: Enter a link to your integration’s help documentation
- Contact Emails: Enter email addresses of contacts in your organization
- Domains: Enter the domains associated with your integration
Save and Copy Credentials
Click Save to create the integration. Then copy the Client ID and click Show secret to copy the Client Secret.
- Store both values securely for use later
- The Client Secret can be revealed using the Show secret button
Create the StackOne Connector Profile
Create a Connector Profile
Link an Account