Skip to main content

Gong

Availability
Available CoreAvailable StandardAvailable PlusAvailable ProAvailable Enterprise FlexAvailable Self-Managed EnterpriseAvailable PyAirbyte
Support Level
Marketplace
Connector Version
1.2.1 (last updated 16 days ago)
Sync Success Rate
Usage Rate
Definition ID
32382e40-3b49-4b99-9c5c-4076501914e7

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
  • For OAuth 2.0 authentication: the following API scopes must be granted: api:calls:read:basic, api:calls:read:extensive, api:calls:read:transcript, api:users:read, api:stats:scorecards, api:stats:interaction, api:settings:scorecards:read
  • For API Key authentication: the API key must have the same scopes listed above granted in 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. Private calls are excluded.
call transcriptsIncrementalCall transcript segments with speaker identification and timestamped sentences. Transcripts for private calls are excluded.
extensive callsIncrementalDetailed call data including topics, key points, trackers, interaction stats, and media. Private calls are excluded.
scorecardsFull RefreshScorecard definitions and configurations
usersFull RefreshUser profiles and settings

Private calls​

Starting with version 1.1.0, the connector excludes calls marked as private (isPrivate: true in the Gong API) from the calls and extensive calls streams. Because call transcripts is a substream of calls, transcripts for private calls are also excluded. Gong requires this behavior for OAuth app listing approval, and the Gong API does not expose a server-side filter for this field, so the connector applies the filter client-side after fetching records.

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.

IP allow list​

If you use Airbyte Cloud and your organization restricts access to specific IPs, add the Airbyte Cloud IP addresses to your allow list.

Reference​

Config fields reference

Field
Type
Property name
object
credentials
integer
num_workers
string
start_date

Changelog​

Expand to review
VersionDatePull RequestSubject
1.2.12026-05-0777858Expose num_workers config field for user-configurable concurrency
1.2.02026-05-0777859Promoted release candidate to GA
1.2.0-rc.32026-05-0577049Revert default_concurrency from 5 to 4 based on Phase 2 results
1.2.0-rc.22026-04-2877049Increase default_concurrency from 4 to 5 based on Phase 1 health check results
1.2.0-rc.12026-04-2777049Add concurrency support with default_concurrency=4; enable progressive rollout
1.1.12026-04-2176593Update dependencies
1.1.02026-04-2076454Filter out private calls (isPrivate: true) from calls and extensiveCalls streams per Gong API listing requirements
1.1.02026-04-16PR_NUMBERFilter out private calls (isPrivate: true) from calls and extensiveCalls streams per Gong API listing requirements
1.0.12026-04-1076229Set deadlineAction to auto_upgrade for 1.0.0 breaking change
1.0.02026-03-3075248Fix schema bugs in extensiveCalls stream: define context as array type and widen value field to accept string, number, boolean, object, and array types. This is a breaking change for users syncing the extensiveCalls stream. See the migration guide.
0.6.32026-03-2775195Migrate OAuth scope to scopes object array for granular scopes support
0.6.22026-03-2475388Update dependencies
0.6.12026-03-2075253Fix incremental sync for extensiveCalls and answeredScorecards not filtering server-side
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
Was this page helpful?