Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Gong

Discover Gong team members and Business admins, and track per-user daily call activity across your organization

Gong is a revenue intelligence platform that records and analyzes customer calls, meetings and emails. The Gong integration connects your Gong company to Harmony as a SaaS Applications integration. Once connected, Harmony pulls your Gong team members, flags who holds Business admin permissions, and collects per-user daily call activity, giving you visibility into who uses their Gong seat and how.

What the Gong integration enables

Capability
Description

User Discovery

Surface every Gong team member in Harmony's inventory with name, email, title, manager and active status

Admin Visibility

See which users hold Business admin permissions, plus the permission profiles each user is assigned

Activity Tracking

Monitor per-user daily call activity - calls hosted, listened to, shared, reviewed and scored

Multi-Instance Support

Connect multiple Gong companies for organizations with separate accounts

Prerequisites

  1. A Gong technical administrator - only a tech admin can create the API key Harmony uses. API keys are available on any Gong plan.

  2. A Harmony account with admin privileges

Credentials

The Gong integration uses a Gong API key, which comes as two values:

  • Access Key - the key identifier

  • Access Key Secret - shown only once when the key is created. This value is masked in Harmony after you save it.

It also accepts an optional API Base URL. Gong assigns some companies their own API host (for example https://company-17.api.gong.io). Leave the field empty to use https://api.gong.io.

Connecting Gong to Harmony

Step 1: Create a Gong API key

  1. In Gong, click Admin center in the left sidebar

  2. In the Settings tab, click API under Ecosystem

  3. Click + Get API key

  4. Enter a name in the Key name field (for example, Harmony Integration)

  5. Leave the TTL (days) field empty so the key does not expire

  6. Leave the Trusted IPs field empty

  7. Click Get API key

  8. Copy the access key and secret - the secret cannot be retrieved once you close the dialog

  9. Click Done

The same API page shows your company's API base URL. If it is anything other than https://api.gong.io, copy it for Step 2.

Step 2: Enter the credentials in Harmony

  1. Log in to your Harmony dashboard

  2. Go to Settings > Integrations

  3. Find Gong under SaaS Applications (or search for it by name) and click its card

  4. If a Gong instance is already connected, click + Create instance

  5. Enter an Instance name (required), for example the name of your Gong company

  6. Enter the Access Key and Access Key Secret from Step 1

  7. If Gong showed a company-specific base URL, enter it in API Base URL. Otherwise leave the field empty

  8. Click Connect

Harmony validates the credentials at save time by calling Gong's user-list endpoint. If Gong rejects the key, refuses the request, or the base URL is wrong, the save fails immediately with an error that says which. An API Base URL other than https://api.gong.io or a https://<instance>.api.gong.io host is rejected before Gong is called.

Disconnecting Gong from Harmony

  1. Log in to your Harmony dashboard

  2. Navigate to Settings > Integrations

  3. Find Gong under SaaS Applications and click the integration card

  4. Click the delete (trash) icon next to the instance you want to remove, and confirm when prompted

Once disconnected, Harmony stops syncing data from Gong. Previously synced data remains available in Harmony. You can also revoke the API key in Gong under Admin center > Settings > API.

What Harmony Syncs from Gong

Data
Description

Team members

Name, email, email aliases, title, manager, creation date, active/inactive status, and the user's data-capture settings (whether web conferences are recorded, emails imported, and similar)

Roles

Admin for users whose permission profile grants Business admin permissions (Manage general business settings), member for everyone else, plus the names of the permission profiles each user holds across your workspaces

Daily activity

Per-user, per-day counts: calls hosted, own and others' calls listened to, calls shared internally and externally, feedback given and requested, scorecards filled, comments given, and calls marked as feedback

Only actions the user takes in Gong count as using the seat: listening to, sharing, reviewing, scoring and commenting on calls. Calls hosted are shown as activity but do not count as use, because Gong records most of them by itself (calendar meetings it joins and calls imported from a dialer). Being on calls another user's Gong recorded, and feedback, scorecards and comments that other people gave the user, are not collected. So a rep whose calls Gong records but who never opens Gong, or whose calls only a manager reviews, shows as inactive. Only non-zero daily counts are recorded. Gong's synthetic "avatar" users, which represent Gong employees, are excluded.

Sync frequency:

  • Team members and roles refresh every 6 hours

  • Daily activity is collected once a day, through the day before yesterday (UTC), so every day is read once its counts are final. Days are calendar days in your Gong company's time zone

Historical data on first connection:

On the first sync, Harmony collects up to 90 days of daily activity, in batches of up to 30 days. Later syncs continue from where the previous one stopped.

What Harmony does not sync

  • Licensed seat count and per-user seat type. Gong's API does not expose licences, seats or plans anywhere. Harmony shows how many team members are active and how they use Gong. Record the number of seats you purchased on the Gong contract in Harmony.

  • Technical admins. Gong marks technical admins on its Team members page, but no API returns that flag. A technical admin whose permission profile does not grant Business admin permissions appears as a member.

  • Last sign-in time. Gong's API has no last-seen field. The most recent day with call activity is the usage signal.

  • Calls, recordings, transcripts and emails. Harmony reads aggregated activity counts only.

Permissions Explained

Gong API keys are not limited to specific scopes. Harmony uses the key only for these read operations:

Gong endpoint
What Harmony reads

GET /v2/users

The team-member roster

GET /v2/workspaces

Workspace list, to look up permission profiles

GET /v2/all-permission-profiles

Each workspace's permission profiles and their rights

GET /v2/permission-profile/users

Which users hold each permission profile

POST /v2/stats/activity/aggregate-by-period

Per-user daily activity counts (a read-only query)

POST /v2/stats/activity/aggregate

Your company's time zone, to date activity by your local day (a read-only query)

Gong limits each company to 3 API calls per second and 10,000 per day, shared by every integration your company runs. Harmony sends at most 2 requests per second and uses a small part of the daily budget: roughly one activity request per 100 active users per day, plus the roster and permission-profile requests every 6 hours. The permission-profile lookup is capped at 200 requests per sync.

Use Cases

Seat Utilization

Compare the number of active Gong team members with the seats on your Gong contract, and find users who have not listened to, shared or reviewed a call in weeks before your next renewal.

Access Review

Review who holds Business admin permissions in Gong and which permission profiles each user is assigned.

Offboarding

Confirm that departing employees have been deactivated in Gong as part of Harmony offboarding workflows.

Troubleshooting

"Gong rejected the access key"

Possible causes:

  • The access key or secret was copied incorrectly, or the two were swapped

  • The API key was deleted in Gong, or its TTL expired

Solutions:

  1. Create a new key under Admin center > Settings > API and leave TTL (days) empty

  2. Enter the new access key and secret in Harmony

"Gong refused the request (403)"

Possible causes:

  • The API key has Trusted IPs set, and Harmony's addresses are not on the list

Solutions:

  1. Remove the Trusted IPs restriction from the key, or contact Harmony Support for the addresses Harmony connects from and add them

"Gong answered 404" or "could not reach Gong"

Possible causes:

  • The API Base URL does not match your company's Gong API host

Solutions:

  1. Copy the base URL shown under Admin center > Settings > API in Gong into the API Base URL field, or leave the field empty to use https://api.gong.io

The integration worked and then started failing

Possible causes:

  • The API key reached the end of its TTL

  • A tech admin revoked the key in Gong

  • Trusted IPs were added to the key without Harmony's addresses

Solutions:

  1. If the key expired or was revoked, create a new key with no TTL, then delete the Gong instance in Harmony and create it again with the new key (Gong's key fields cannot be changed on a connected instance)

  2. If Trusted IPs block Harmony, remove the restriction or add Harmony's addresses (contact Harmony Support for them). Harmony retries daily, so syncs resume on their own once the addresses are allowed

Every user shows as a member

Possible causes:

  • None of the permission profiles assigned to your users grants Manage general business settings, the permission Gong uses for Business admins

  • Your admins are technical admins only, which the Gong API does not report

  • Harmony could not read permission profiles on the last sync, because of a temporary Gong error or rate limit, or because your workspaces and profiles would take more than 200 requests to read. Users then show as members with no permission profiles listed

Solutions:

  1. In Gong, check which permission profiles grant Manage general business settings and which users hold them

  2. If profiles are missing for every user, wait for the next sync (every 6 hours). If they stay missing and your company has many workspaces, contact Harmony Support

Data & Privacy

Key privacy principles

For information about how Harmony handles your data, see our Privacy Policy.

  • Harmony accesses Gong data in read-only mode and does not modify any data in your Gong account

  • Harmony reads team members, permission profiles and aggregated activity counts. It does not access calls, recordings, transcripts or emails

  • Access can be revoked at any time by revoking the API key in Gong or disconnecting the integration in Harmony

Last updated

Was this helpful?