Skip to main content

Gong

Availability
Available CoreAvailable StandardAvailable PlusAvailable ProAvailable Enterprise FlexAvailable Self-Managed EnterpriseAvailable PyAirbyte
Support Level
Marketplace
Connector Version
1.3.1 (last updated 20 hours ago)
Sync Success Rate
Medium
Usage Rate
High
Data workers used
0.2 per sync (Learn more)
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 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: an access key and access key secret generated from the Gong API settings, with the same scopes listed above

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 syncs all available data from the earliest recorded call. Without a start date, the initial sync fetches your entire call history, which can be large. Set a start date to limit how far back the first sync reaches.
  • Number of Concurrent Threads (optional). Controls how many streams are synced in parallel. The default is 4 and the valid range is 1–10. The connector paces itself to Gong's 3 requests-per-second limit no matter how many threads you use, so raising this value mainly helps when streams are waiting on Gong to respond rather than on the rate limit.

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, media, and CRM context. 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​

Gong limits API access to 3 calls per second and 10,000 calls per day. If you exceed either limit, the API returns HTTP status code 429 with a Retry-After header indicating how long to wait.

Starting with version 1.3.1, the connector handles both sides of this:

  • It throttles its own requests to 3 per second across all streams, so syncs stay under the per-second limit before Gong has to reject anything.
  • When Gong does return a 429, the connector waits for the interval in the Retry-After header and then retries, instead of backing off on a fixed schedule.

The connector doesn't pace itself against the 10,000-calls-per-day quota, so a large backfill or a frequent sync schedule can still exhaust it.

The call transcripts stream is a substream of the calls stream. Starting with version 1.3.0, it batches up to 100 call IDs into each POST /v2/calls/transcript request instead of sending one request per call. This sharply reduces the request volume during large backfills, making it much less likely you'll hit Gong's rate limit or daily quota, though very large tenants can still approach these limits. 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.3.12026-07-2780891Throttle requests to Gong's 3 requests-per-second limit and honor the Retry-After header when a 429 occurs
1.3.02026-07-2282260Batch call transcripts requests to fetch up to 100 call IDs per API call, reducing the request volume that drove rate-limit (429) errors and daily-quota exhaustion under one request per call
1.2.112026-07-2182434Update dependencies
1.2.102026-07-1481846Update dependencies
1.2.92026-07-0780750Remove 90-day default lookback window; when start_date is not configured the connector now syncs all available data from the earliest recorded call, matching the Gong API default and the spec description
1.2.82026-06-3081076Update dependencies
1.2.72026-06-2380481Update dependencies
1.2.62026-06-1679879Update dependencies
1.2.52026-06-1078521Send OAuth refresh grant_type and refresh_token as URL query parameters to match Gong's documented refresh endpoint shape
1.2.42026-06-1078476Add context: Extended and contextTiming to extensiveCalls request body so Gong returns context fields
1.2.32026-06-0979338Update dependencies
1.2.22026-06-0277254Update dependencies
1.2.12026-05-1177858Expose num_workers config field for user-configurable concurrency
1.2.02026-05-0777859Promoted release candidate to GA
1.2.0-rc.32026-05-0577785Revert default_concurrency from 5 to 4 based on Phase 2 results
1.2.0-rc.22026-04-2877549Increase 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.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?