Skip to main content

Gong

This page contains the setup guide and reference information for the Gong source connector.

Prerequisites

  • A Gong account with technical administrator permissions
  • For API Key authentication: an access key and access key secret generated from the Gong API settings

Setup guide

Step 1: Authenticate with Gong

You can authenticate to Gong using one of two methods:

For Airbyte Cloud:

  • OAuth 2.0 (recommended). Click Authenticate your Gong account to sign in through Gong's OAuth flow. This method handles token refresh automatically. You need a Gong account with technical administrator permissions to authorize the connection.
  • API Key. Authenticate using an access key and access key secret. To generate credentials:

    1. Log in to your Gong account as a technical administrator.
    2. Navigate to Company Settings > Ecosystem > API.
    3. Click Create to generate an access key and access key secret.
    4. Copy both values immediately. The access key secret is only displayed once.

    For more details, see the Gong API documentation.

Step 2: Configure the connector

  • Start Date (optional). The date from which to fetch data, in ISO-8601 format (for example, 2024-01-01T00:00:00Z). This applies to incremental streams. If not specified, the connector fetches data from the last 90 days.

Supported sync modes

The Gong source connector supports the following sync modes:

  • Full Refresh
  • Incremental

Supported streams

This source syncs the following streams:

StreamSync ModeDescription
answered scorecardsIncrementalScorecard responses with review timestamps
callsIncrementalCall metadata including participants, duration, and timestamps
call transcriptsIncrementalCall transcript segments with speaker IDs, topics, and timestamped sentences
extensive callsIncrementalDetailed call data including transcripts, topics, and interaction stats
scorecardsFull RefreshScorecard definitions and configurations
usersFull RefreshUser profiles and settings

Performance considerations

The Gong connector should not run into Gong API limitations under normal usage. Gong limits API access to 3 calls per second and 10,000 calls per day. If you exceed these limits, the API returns HTTP status code 429 with a Retry-After header indicating when to retry.

The call transcripts stream fetches transcripts one call at a time as a substream of the calls stream. On the initial sync for accounts with a large number of calls, this may take longer than a bulk-fetch approach. Subsequent incremental syncs only fetch transcripts for new calls.

Reference

Config fields reference

Field
Type
Property name
object
credentials
string
start_date

Changelog

Expand to review
VersionDatePull RequestSubject
0.6.02026-03-1875132Add incremental sync support for callTranscripts stream
0.5.52026-02-2473782Update dependencies
0.5.42026-02-1771754Add callTranscripts stream to sync call transcripts
0.5.32026-02-1073037Update dependencies
0.5.22026-02-0372579Update dependencies
0.5.12026-01-2065382Update dependencies
0.5.02026-01-1671356Add OAuth 2.0 authentication support with SelectiveAuthenticator
0.4.142026-01-1371344Add 404 error handlers and fix CDK import path
0.4.132025-08-0964594Update dependencies
0.4.122025-08-0264200Update dependencies
0.4.112025-07-1963504Update dependencies
0.4.102025-07-1263139Update dependencies
0.4.92025-07-0562641Update dependencies
0.4.82025-06-2161866Update dependencies
0.4.72025-06-1461085Update dependencies
0.4.62025-05-2460651Update dependencies
0.4.52025-05-1059892Update dependencies
0.4.42025-05-0359272Update dependencies
0.4.32025-04-2657696Update dependencies
0.4.22025-04-0557039Update dependencies
0.4.12025-03-2956494Update dependencies
0.4.02025-03-2555803Add incremental sync for extensiveCalls
0.3.162025-03-2255969Update dependencies
0.3.152025-03-0855269Update dependencies
0.3.142025-03-0154962Update dependencies
0.3.132025-02-2254394Update dependencies
0.3.122025-02-1553718Update dependencies
0.3.112025-02-0853334Update dependencies
0.3.102025-02-0152824Update dependencies
0.3.92025-01-2552342Update dependencies
0.3.82025-01-1851704Update dependencies
0.3.72025-01-1151059Update dependencies
0.3.62024-12-2850521Update dependencies
0.3.52024-12-2150017Update dependencies
0.3.42024-12-1449538Update dependencies
0.3.32024-12-1249155Update dependencies
0.3.22024-11-1436604Add incremental Feature
0.3.12024-10-2947824Update dependencies
0.3.02024-09-0445117Add new stream extensive calls
0.2.12024-08-1644196Bump source-declarative-manifest version
0.2.02024-08-1544144Refactor connector to manifest-only format
0.1.172024-08-1043481Update dependencies
0.1.162024-08-0343275Update dependencies
0.1.152024-07-2742614Update dependencies
0.1.142024-07-2042149Update dependencies
0.1.132024-07-1341794Update dependencies
0.1.122024-07-1041408Update dependencies
0.1.112024-07-0941110Update dependencies
0.1.102024-07-0640890Update dependencies
0.1.92024-06-2640374Update dependencies
0.1.82024-06-2240175Update dependencies
0.1.72024-06-0639226[autopull] Upgrade base image to v1.2.2
0.1.62024-05-2838596Make connector compatible with builder
0.1.52024-04-1937169Updating to 0.80.0 CDK
0.1.42024-04-1837169Manage dependencies with Poetry.
0.1.32024-04-1537169Base image migration: remove Dockerfile and use the python-connector-base image
0.1.22024-04-1237169schema descriptions
0.1.12024-02-0534847Adjust stream schemas and make ready for airbyte-lib
0.1.02022-10-2718819Add Gong Source Connector