> ## Documentation Index
> Fetch the complete documentation index at: https://nango-wari-migrated-bigcommerce-docs.mintlify.site/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>

### Others

| Function name                            | Description                                                                                                                                                 | Type                                           | Source code                                                                                                                                 |
| ---------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| `add-call-users-access`                  | Grant individual users access to specific calls.                                                                                                            | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gong/actions/add-call-users-access.ts)                  |
| `ask-entity`                             | Ask a natural language question about a Gong entity using AI.                                                                                               | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gong/actions/ask-entity.ts)                             |
| `assign-prospects-cool-off-override`     | Assign prospects to a Gong Engage flow bypassing the cool-off period restriction.                                                                           | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gong/actions/assign-prospects-cool-off-override.ts)     |
| `create-meeting`                         | Create a new Gong meeting (Beta).                                                                                                                           | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gong/actions/create-meeting.ts)                         |
| `create-permission-profile`              | Create a new permission profile in a Gong workspace                                                                                                         | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gong/actions/create-permission-profile.ts)              |
| `delete-crm-integration`                 | Delete a registered generic CRM integration from Gong.                                                                                                      | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gong/actions/delete-crm-integration.ts)                 |
| `delete-data-for-email`                  | Erase all Gong data associated with an email address (GDPR / data privacy).                                                                                 | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gong/actions/delete-data-for-email.ts)                  |
| `delete-data-for-phone`                  | Erase all Gong data associated with a phone number (GDPR / data privacy)                                                                                    | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gong/actions/delete-data-for-phone.ts)                  |
| `delete-meeting`                         | Delete a Gong meeting (Beta).                                                                                                                               | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gong/actions/delete-meeting.ts)                         |
| `fetch-call-extensive-data`              | Fetch detailed Gong call data including content, interaction, and collaboration fields for specific calls.                                                  | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gong/actions/fetch-call-extensive-data.ts)              |
| `fetch-call-transcripts`                 | Fetch a page of Gong call transcripts, optionally filtered by date range, workspace, or call IDs. Use the returned nextCursor to retrieve subsequent pages. | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gong/actions/fetch-call-transcripts.ts)                 |
| `get-bulk-assignment-results`            | Poll the results of a bulk prospect-to-flow assignment job.                                                                                                 | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gong/actions/get-bulk-assignment-results.ts)            |
| `get-call-media`                         | Retrieve the media download URL for a Gong call recording                                                                                                   | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gong/actions/get-call-media.ts)                         |
| `get-call-transcript`                    | Retrieve the transcript for a single Gong call.                                                                                                             | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gong/actions/get-call-transcript.ts)                    |
| `get-call-users-access`                  | Retrieve the list of users that have individual access to a specific call.                                                                                  | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gong/actions/get-call-users-access.ts)                  |
| `get-call`                               | Retrieve a single call from Gong.                                                                                                                           | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gong/actions/get-call.ts)                               |
| `get-coaching-metrics`                   | Retrieve all coaching metrics from Gong.                                                                                                                    | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gong/actions/get-coaching-metrics.ts)                   |
| `get-crm-entities`                       | Retrieve CRM objects (accounts, contacts, deals, leads) from the Gong CRM integration.                                                                      | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gong/actions/get-crm-entities.ts)                       |
| `get-crm-entity-schema`                  | List CRM entity schema fields registered in Gong                                                                                                            | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gong/actions/get-crm-entity-schema.ts)                  |
| `get-crm-integration`                    | Retrieve details of the registered generic CRM integration                                                                                                  | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gong/actions/get-crm-integration.ts)                    |
| `get-crm-request-status`                 | Check the status of an async CRM upload request.                                                                                                            | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gong/actions/get-crm-request-status.ts)                 |
| `get-data-for-email`                     | Retrieve all Gong references associated with a specific email address.                                                                                      | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gong/actions/get-data-for-email.ts)                     |
| `get-data-for-phone`                     | Retrieve all Gong references associated with a specific phone number.                                                                                       | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gong/actions/get-data-for-phone.ts)                     |
| `get-entity-brief`                       | Generate an AI brief for a CRM entity using Gong's AI briefer                                                                                               | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gong/actions/get-entity-brief.ts)                       |
| `get-flow-steps`                         | Retrieve details and steps for one or more Gong Engage flows.                                                                                               | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gong/actions/get-flow-steps.ts)                         |
| `get-integration-settings`               | Retrieve Gong integration settings.                                                                                                                         | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gong/actions/get-integration-settings.ts)               |
| `get-logs`                               | Retrieve Gong audit logs by type and time range.                                                                                                            | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gong/actions/get-logs.ts)                               |
| `get-meeting-integration-status`         | Validate the Gong meeting integration status.                                                                                                               | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gong/actions/get-meeting-integration-status.ts)         |
| `get-permission-profile`                 | Retrieve a specific Gong permission profile by ID.                                                                                                          | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gong/actions/get-permission-profile.ts)                 |
| `get-scorecard`                          | Retrieve a single scorecard from Gong.                                                                                                                      | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gong/actions/get-scorecard.ts)                          |
| `get-stats-activity-aggregate-by-period` | Retrieve aggregated activity statistics for users over a date range, grouped by time period.                                                                | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gong/actions/get-stats-activity-aggregate-by-period.ts) |
| `get-stats-activity-aggregate`           | Retrieve aggregated activity statistics for defined users on a specific date.                                                                               | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gong/actions/get-stats-activity-aggregate.ts)           |
| `get-stats-activity-day-by-day`          | Retrieve daily activity statistics for applicable users over a date range.                                                                                  | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gong/actions/get-stats-activity-day-by-day.ts)          |
| `get-stats-activity-scorecards`          | Retrieve answered scorecard statistics for reviewed users or specific scorecards over a date range.                                                         | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gong/actions/get-stats-activity-scorecards.ts)          |
| `get-stats-interaction`                  | Retrieve interaction statistics for users on a specific date                                                                                                | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gong/actions/get-stats-interaction.ts)                  |
| `get-tracker`                            | Retrieve a single keyword tracker from Gong.                                                                                                                | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gong/actions/get-tracker.ts)                            |
| `get-user-settings-history`              | Retrieve the settings change history for a specific Gong user.                                                                                              | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gong/actions/get-user-settings-history.ts)              |
| `get-user`                               | Retrieve a single user from Gong.                                                                                                                           | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gong/actions/get-user.ts)                               |
| `get-workspace`                          | Retrieve a single Gong workspace by ID.                                                                                                                     | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gong/actions/get-workspace.ts)                          |
| `list-call-outcomes`                     | List all configured call outcomes in Gong.                                                                                                                  | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gong/actions/list-call-outcomes.ts)                     |
| `list-call-transcripts`                  | List call transcripts from Gong using date-range or other filters.                                                                                          | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gong/actions/list-call-transcripts.ts)                  |
| `list-calls`                             | List calls from Gong with optional date-range filters.                                                                                                      | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gong/actions/list-calls.ts)                             |
| `list-flow-folders`                      | List Gong Engage flow folders                                                                                                                               | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gong/actions/list-flow-folders.ts)                      |
| `list-flow-prospects`                    | List prospects and their current flow assignment status.                                                                                                    | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gong/actions/list-flow-prospects.ts)                    |
| `list-flows`                             | List Gong Engage flows owned by a specific user.                                                                                                            | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gong/actions/list-flows.ts)                             |
| `list-library-folder-content`            | List calls within a specific Gong library folder                                                                                                            | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gong/actions/list-library-folder-content.ts)            |
| `list-library-folders`                   | Retrieve all Gong library folders.                                                                                                                          | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gong/actions/list-library-folders.ts)                   |
| `list-permission-profile-users`          | List all users attached to a specific Gong permission profile                                                                                               | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gong/actions/list-permission-profile-users.ts)          |
| `list-permission-profiles`               | List all permission profiles in a Gong workspace.                                                                                                           | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gong/actions/list-permission-profiles.ts)               |
| `list-scorecards`                        | List scorecards from Gong                                                                                                                                   | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gong/actions/list-scorecards.ts)                        |
| `list-tasks`                             | List tasks for the current Gong user.                                                                                                                       | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gong/actions/list-tasks.ts)                             |
| `list-trackers`                          | List keyword trackers from Gong.                                                                                                                            | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gong/actions/list-trackers.ts)                          |
| `list-users`                             | List users from Gong                                                                                                                                        | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gong/actions/list-users.ts)                             |
| `list-workspaces`                        | List all workspaces in the Gong account.                                                                                                                    | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gong/actions/list-workspaces.ts)                        |
| `post-digital-interaction`               | Post a digital interaction event to Gong (web visits, email opens, content engagement, etc.)                                                                | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gong/actions/post-digital-interaction.ts)               |
| `register-crm-integration`               | Register a generic CRM integration with Gong                                                                                                                | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gong/actions/register-crm-integration.ts)               |
| `remove-call-users-access`               | Remove individual user access from specific calls                                                                                                           | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gong/actions/remove-call-users-access.ts)               |
| `remove-prospects-from-flow`             | Unassign prospects from an Engage flow by their flow instance IDs.                                                                                          | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gong/actions/remove-prospects-from-flow.ts)             |
| `unassign-flow-by-crm-id`                | Unassign prospects from an Engage flow using their CRM prospect IDs                                                                                         | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gong/actions/unassign-flow-by-crm-id.ts)                |
| `update-integration-settings`            | Update Gong integration settings.                                                                                                                           | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gong/actions/update-integration-settings.ts)            |
| `update-meeting`                         | Update an existing Gong meeting (Beta).                                                                                                                     | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gong/actions/update-meeting.ts)                         |
| `update-permission-profile`              | Update an existing Gong permission profile.                                                                                                                 | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gong/actions/update-permission-profile.ts)              |
| `update-task`                            | Update a Gong task for the current user.                                                                                                                    | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gong/actions/update-task.ts)                            |
| `upload-call`                            | Create a call record in Gong from an external telephony or recording system (step 1 of the two-step ingestion flow)                                         | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gong/actions/upload-call.ts)                            |
| `upload-crm-entities`                    | Upload CRM objects (accounts, contacts, deals, leads) to Gong.                                                                                              | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gong/actions/upload-crm-entities.ts)                    |
| `upload-crm-entity-schema`               | Upload or update the object schema fields for a CRM entity type in Gong.                                                                                    | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gong/actions/upload-crm-entity-schema.ts)               |
| `call-outcomes`                          | Sync configured call outcomes from Gong.                                                                                                                    | [Sync](/guides/functions/syncs/sync-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gong/syncs/call-outcomes.ts)                            |
| `call-transcripts`                       | Sync 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`                                  | Sync calls from Gong.                                                                                                                                       | [Sync](/guides/functions/syncs/sync-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gong/syncs/calls.ts)                                    |
| `library-folders`                        | Sync Gong library folders                                                                                                                                   | [Sync](/guides/functions/syncs/sync-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gong/syncs/library-folders.ts)                          |
| `scorecards`                             | Sync scorecards from Gong                                                                                                                                   | [Sync](/guides/functions/syncs/sync-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gong/syncs/scorecards.ts)                               |
| `trackers`                               | Sync keyword trackers from Gong.                                                                                                                            | [Sync](/guides/functions/syncs/sync-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gong/syncs/trackers.ts)                                 |
| `users`                                  | Sync users from Gong                                                                                                                                        | [Sync](/guides/functions/syncs/sync-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gong/syncs/users.ts)                                    |
| `workspaces`                             | Sync workspaces from Gong.                                                                                                                                  | [Sync](/guides/functions/syncs/sync-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/gong/syncs/workspaces.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>