Skip to main content
With the Gong integration, you can see who has access to Gong, and at what level:
  • Sync Gong users (including deactivated users), and each workspace’s permission profiles with their members
  • Review Gong permission profile membership in access reviews
  • Set the right resource owners for each workspace and permission profile
Opal connects to one Gong company through a Gong API key. To connect several Gong companies, add a Gong app in Opal for each one.

Supported resources

This is a read-only integration. Opal can’t grant or revoke Gong permission profiles. Gong’s API has no endpoint that assigns a user to a permission profile or removes them from one. Its API can only read profiles and their members. In Gong, profiles are assigned in the Admin center or by Gong’s team member provisioning, which applies a profile to each member of an identity provider group.To manage Gong access through Opal, map an Okta or Microsoft Entra ID group to a permission profile in Gong’s team member provisioning, with Update settings set to Automatic updates. Then manage that group in Opal with the Okta or Azure integration. When a user gains or loses the group, Gong updates their permission profile.

How Gong access maps to Opal

  • Workspaces: each Gong workspace is a resource, with its permission profiles nested under it.
  • Permission profiles: each profile is a resource, and its members are the users Gong lists for that profile. A user holds one permission profile in each workspace they belong to.
  • Users: Opal syncs all Gong users returned by the API, including deactivated users. Deactivated users can still hold permission profiles in Gong, so they remain visible for reviews.

Requirements

Before you begin, you must:
  • Be an Opal Admin
  • Be a Gong Technical Administrator, which is the only role that can create API keys
  • Ask the Opal team to enable the Gong integration for your organization

Configuration steps

1. Create a Gong API key

  1. In Gong, go to Admin center > Settings > Ecosystem > API, and select + Get API key.
  2. Name the key, for example Opal. Leave the expiration empty, because Opal stops syncing when the key expires.
  3. Leave Trusted IPs empty unless you’ve confirmed Opal’s outbound IP addresses with the Opal team. Gong rejects calls from any other address.
  4. Select Get API key, then copy the Access key and Access key secret. Gong shows the secret only once.
  5. On the same page, copy your API base URL, for example https://us-12345.api.gong.io. You’ll enter its first part, us-12345, in Opal.
A Gong API key can call every Gong API endpoint. Opal only reads users, workspaces, and permission profiles, and never reads calls, transcripts, or emails. It calls only these endpoints:

2. Create the Gong app in Opal

In Opal, go to Inventory > +App and select Gong. Fill in the following fields: Opal checks the API key when you save the app.

3. Import workspaces and permission profiles

After you save the app, import the workspaces and permission profiles you want to review: on the app’s Assets tab, select Import assets. Opal pulls access only for imported items, so profile members appear after the next sync.

Troubleshooting

Last modified on November 16, 2026