> ## Documentation Index
> Fetch the complete documentation index at: https://nango.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Gong

## Overview

<CardGroup cols={3}>
  <Card title="Pre-built tooling" icon="screwdriver-wrench" href="#pre-built-tooling" />

  <Card title="Pre-built integrations" icon="square-check" href="#pre-built-integrations" />

  <Card title="Access requirements" icon="triangle-exclamation" href="#access-requirements" />

  <Card title="Setup guide" icon="rocket" href="#setup-guide" />

  <Card title="Useful links" icon="circle-info" href="#useful-links" />

  <Card title="API gotchas" icon="biohazard" href="#api-gotchas" />
</CardGroup>

## Pre-built tooling

<AccordionGroup>
  <Accordion title="✅ Authorization">
    | Tools                           | Status |
    | ------------------------------- | ------ |
    | Pre-built authorization (Basic) | ✅      |
    | Pre-built authorization UI      | ✅      |
    | Custom authorization UI         | ✅      |
    | End-user authorization guide    | ✅      |
    | Expired credentials detection   | ✅      |
  </Accordion>

  <Accordion title="✅ Read & write data">
    | Tools                                     | Status                         |
    | ----------------------------------------- | ------------------------------ |
    | Pre-built integrations                    | ✅                              |
    | API unification                           | ✅                              |
    | 2-way sync                                | ✅                              |
    | Webhooks from Nango on data modifications | ✅                              |
    | Real-time webhooks from 3rd-party API     | 🚫 (time to contribute: \<48h) |
    | Proxy requests                            | ✅                              |
  </Accordion>

  <Accordion title="✅ Observability & data quality">
    | Tools                   | Status |
    | ----------------------- | ------ |
    | HTTP request logging    | ✅      |
    | End-to-end type safety  | ✅      |
    | Data runtime validation | ✅      |
    | OpenTelemetry export    | ✅      |
    | Slack alerts on errors  | ✅      |
    | Integration status API  | ✅      |
  </Accordion>

  <Accordion title="✅ Customization">
    | Tools                              | Status                         |
    | ---------------------------------- | ------------------------------ |
    | Create or customize use-cases      | ✅                              |
    | Pre-configured pagination          | 🚫 (time to contribute: \<48h) |
    | Pre-configured rate-limit handling | 🚫 (time to contribute: \<48h) |
    | Per-customer configurations        | ✅                              |
  </Accordion>
</AccordionGroup>

### Calls

| Function name            | Description                                  | Type                                           | Source code                                                                                                                 |
| ------------------------ | -------------------------------------------- | ---------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
| `fetch-call-transcripts` | Fetches a list of call transcripts from Gong | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gong/actions/fetch-call-transcripts.ts) |
| `call-transcripts`       | Fetches a list of call transcripts from Gong | [Sync](/guides/functions/syncs/sync-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gong/syncs/call-transcripts.ts)         |
| `calls`                  | Fetches a list of calls from Gong            | [Sync](/guides/functions/syncs/sync-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gong/syncs/calls.ts)                    |

### Users

| Function name | Description                    | Type                                           | Source code                                                                                              |
| ------------- | ------------------------------ | ---------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
| `users`       | Fetches the list of gong users | [Sync](/guides/functions/syncs/sync-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gong/syncs/users.ts) |

## Access requirements

| Pre-Requisites    | Status                | Comment                                                                                     |
| ----------------- | --------------------- | ------------------------------------------------------------------------------------------- |
| Paid dev account  | ✅ Not required        | Free, self-signup for a [Gong account](https://www.gong.io/free-trial/).                    |
| Paid test account | ✅ Not required        | Free trial account can be used for testing.                                                 |
| Partnership       | ✅ Not required        |                                                                                             |
| App review        | ⚠️ Required for OAuth | Only required for OAuth apps published to the Gong Collective. Not required for Basic Auth. |
| Security audit    | ✅ Not required        |                                                                                             |

## Setup guide

Gong offers two authentication methods: Basic Auth (API Key) and OAuth. Nango supports both methods.

### Basic Auth Setup

<Steps>
  <Step title="Create a Gong account">
    If you don't already have one, sign up for a [Gong account](https://www.gong.io/free-trial/).
  </Step>

  <Step title="Obtain API credentials">
    1. Log in to your Gong account.
    2. Navigate to **Company Settings** > **Ecosystem** > **API**.
    3. Click **Get API Key** to generate your API credentials.
    4. You will receive two values:
       * **Access Key**: This is your username in Nango
       * **Access Key Secret**: This is your password in Nango
    5. Make a copy of these credentials as they will be needed when configuring your integration in Nango.
  </Step>

  <Step title="Next">
    Follow the [*Quickstart*](/getting-started/quickstart).
  </Step>
</Steps>

### OAuth Setup

<Steps>
  <Step title="Request a developer account">
    1. Go to [Gong Developer Signup](https://app.gong.io/welcome/developer/sign-up).
    2. Fill out the form with your details and submit.
    3. Wait for approval (this can take up to five working days).
    4. Once approved, you'll receive login credentials for your developer account.
  </Step>

  <Step title="Create a new app">
    1. Log in to your Gong developer account.
    2. Navigate to **Company Settings** > **Ecosystem** > **API**.
    3. Click on the **OAuth** tab.
    4. In the **INTEGRATIONS** tab, click **Create Integration**.
  </Step>

  <Step title="Configure OAuth settings">
    1. Fill in the required app information:
       * **App Name**: Your application's name
       * **Description**: Brief description of your app
       * **Company Website**: Your company's website URL
       * **Redirect URIs**: Add `https://api.nango.dev/oauth/callback`
    2. In the **Required authorization scopes** area, select the scopes that your app needs.
    3. Click **Save** to create your app.
  </Step>

  <Step title="Obtain OAuth credentials">
    1. After creating your app, you'll be provided with:
       * **Client ID**
       * **Client Secret**
    2. Make a copy of these credentials as they will be needed when configuring your integration in Nango.
  </Step>

  <Step title="Submit your app for review (if needed)">
    1. By default, your app will be in "Private" mode and can only be used within your organization.
    2. To make your app available to other Gong customers, you need to publish it to the Gong Collective:
       * Navigate to your app settings
       * Click **Publish to Gong Collective**
       * Complete the required information
       * Submit for review
    3. Wait for Gong's approval before your app can be used by external organizations.
  </Step>

  <Step title="Next">
    Follow the [*Quickstart*](/getting-started/quickstart).
  </Step>
</Steps>

<Tip>Need help getting started? Get help in the [community](https://nango.dev/slack).</Tip>

## Useful links

* [Website](https://www.gong.io/)
* [Create a Gong account](https://www.gong.io/free-trial/)
* [API documentation](https://app.gong.io/settings/api/documentation#overview)
* [Developer signup](https://app.gong.io/welcome/developer/sign-up)
* [Receive access to the API](https://help.gong.io/docs/receive-access-to-the-api)
* [Create an app for Gong](https://help.gong.io/docs/create-an-app-for-gong)
* [OAuth documentation](https://help.gong.io/docs/create-an-app-for-gong#set-up-oauth)
* [API rate limits](https://app.gong.io/settings/api/documentation#overview)
* [SCIM API documentation](https://help.gong.io/docs/provision-team-members-from-a-custom-source-scim)

<Note>Contribute useful links by [editing this page](https://github.com/nangohq/nango/tree/master/docs/integrations/all/gong.mdx)</Note>

## API gotchas

* End users can generate API keys [on the Gong API page](https://app.gong.io/company/api). They must have the "technical administrator" user role to do this.
* Gong uses BASIC auth for their API, but doesn't call them username and password: `Access Key` is the username in Nango and `Access Key Secret` is the password in Nango.
* [Gong rate-limits](https://app.gong.io/settings/api/documentation#overview) are per second and a total of 10k requests a day.
* By default Gong limits your company's access to the service to 3 API calls per second, and 10,000 API calls per day. You may however change these rates by contacting [help](https://help.gong.io/).
* For OAuth integration, Gong uses `api_base_url_for_customer`, which varies for each customer, as its `base_url` for proxy requests. This parameter is returned in the response of `generate-customer-token`.

<Note>Contribute API gotchas by [editing this page](https://github.com/nangohq/nango/tree/master/docs/integrations/all/gong.mdx)</Note>

<Card title="Connect to Gong" icon="link" href="/integrations/all/gong/connect" horizontal>
  Guide to connect to Gong API using Nango Connect.
</Card>