> For the complete documentation index, see [llms.txt](https://docs.harmony.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.harmony.io/integrations/saas-applications/gong.md).

# 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**

{% hint style="warning" %}
If you set a TTL, the key stops working when it expires and Harmony's syncs fail until you create a new key and connect Gong again with it. If your policy requires **Trusted IPs**, contact Harmony Support for the addresses Harmony connects from. Gong rejects requests from any other address with a 403 error.
{% endhint %}

{% hint style="info" %}
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.
{% endhint %}

#### 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**

{% hint style="info" %}
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.
{% endhint %}

### 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.

{% hint style="info" %}
**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
  {% endhint %}

{% hint style="info" %}
**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.
{% endhint %}

#### 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) |

{% hint style="info" %}
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.
{% endhint %}

### Use Cases

<details>

<summary>Seat Utilization</summary>

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.

</details>

<details>

<summary>Access Review</summary>

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

</details>

<details>

<summary>Offboarding</summary>

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

</details>

### Troubleshooting

<details>

<summary>"Gong rejected the access key"</summary>

**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

</details>

<details>

<summary>"Gong refused the request (403)"</summary>

**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

</details>

<details>

<summary>"Gong answered 404" or "could not reach Gong"</summary>

**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`

</details>

<details>

<summary>The integration worked and then started failing</summary>

**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

</details>

<details>

<summary>Every user shows as a member</summary>

**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

</details>

### Data & Privacy

<details>

<summary>Key privacy principles</summary>

For information about how Harmony handles your data, see our [Privacy Policy](https://harmony.io/privacy).

* 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

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.harmony.io/integrations/saas-applications/gong.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
