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
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
A Gong technical administrator - only a tech admin can create the API key Harmony uses. API keys are available on any Gong plan.
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
In Gong, click Admin center in the left sidebar
In the Settings tab, click API under Ecosystem
Click + Get API key
Enter a name in the Key name field (for example,
Harmony Integration)Leave the TTL (days) field empty so the key does not expire
Leave the Trusted IPs field empty
Click Get API key
Copy the access key and secret - the secret cannot be retrieved once you close the dialog
Click Done
Step 2: Enter the credentials in Harmony
Log in to your Harmony dashboard
Go to Settings > Integrations
Find Gong under SaaS Applications (or search for it by name) and click its card
If a Gong instance is already connected, click + Create instance
Enter an Instance name (required), for example the name of your Gong company
Enter the Access Key and Access Key Secret from Step 1
If Gong showed a company-specific base URL, enter it in API Base URL. Otherwise leave the field empty
Click Connect
Disconnecting Gong from Harmony
Log in to your Harmony dashboard
Navigate to Settings > Integrations
Find Gong under SaaS Applications and click the integration card
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
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.
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:
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)
Use Cases
Troubleshooting
Data & Privacy
Last updated
Was this helpful?
