Advanced Analytica Advanced Analytica: IBOM
← All connectors
Gong logo

Source connector

Gong

Set up Gong as a source and move its data into your chosen destination.

Version 1.6.0 certified generally available

Gong

Use this page to set up the Gong source connector and find reference information.

Prerequisites

  • A Gong account with technical administrator permissions
  • For OAuth 2.0 authentication, grant these API scopes: 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, generate an access key and access key secret in Gong API settings. Grant the same scopes listed above.

:::note The connection test checks connectivity by reading the users stream. Therefore, you always need the api:users:read scope.

This scope is required even if you only plan to sync call or scorecard streams. Without it, source setup fails with an unauthorised error.

Credentials inherit the data visibility of the Gong user who created them. If that user can’t see certain calls, the key silently returns fewer or zero records, without an error. :::

Setup

Set up Gong

You can authenticate with Gong using OAuth 2.0 or an API key.

Airbyte Cloud

  • OAuth 2.0 (recommended). Click Authenticate your Gong account to sign in through Gong’s OAuth flow. This method refreshes tokens automatically. You need a Gong account with technical administrator permissions to authorise the connection.
  • API Key. Alternatively, use an access key and access key secret. Generate them as described in the Open Source section below.

Airbyte Open Source

  • API Key. Authenticate with an access key and access key secret. To generate your credentials:

    1. Sign in to your Gong account as a technical administrator.
    2. Go 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 appears only once.

    For more information, see the Gong API documentation.

Configure the connector

  • Start Date (optional). Enter the date from which you want to fetch data in ISO-8601 format, for example, 2024-01-01T00:00:00Z. This setting applies to incremental streams. If omitted, the connector syncs all available data from the earliest recorded call. Set a start date to limit the initial sync period.
  • Number of Concurrent Threads (optional). Set how many streams sync in parallel. The default is 4, and the valid range is 1–10. The connector stays within Gong’s three-requests-per-second limit, regardless of thread count. A higher value mainly helps when streams await Gong’s response rather than the rate limit.
  • Lookback Window (days) (optional). Set the days subtracted from the saved state when each incremental sync starts. The default is 0, which syncs strictly forwards. Set this when calls or scorecards can change after replication. Later syncs can then collect those changes.
  • Scorecards Review Method (optional). Choose which answered scorecards to fetch: MANUAL, AUTOMATIC (scored by Gong’s AI) or BOTH. By default, the Gong API only returns manually reviewed scorecards. Choose AUTOMATIC or BOTH to sync AI-scored scorecards. The default is MANUAL, which preserves the previous behaviour. On existing connections, changing this setting only adds scorecards reviewed after the last sync. Refresh the answered scorecards stream to backfill older scorecards.

Supported sync modes

The Gong source connector supports these sync modes:

  • Full Refresh
  • Incremental

Supported streams

This source syncs these 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

From version 1.1.0, the connector excludes private calls from the calls and extensive calls streams. The Gong API marks these calls as isPrivate: true. Because call transcripts is a substream of calls, the connector also excludes transcripts for private calls. Gong requires this behaviour for OAuth app listing approval. The Gong API doesn’t provide a server-side filter for this field. Therefore, the connector filters records client-side after fetching them.

Performance

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

From version 1.3.1, the connector handles both limits as follows:

  • It limits requests to three per second across all streams. Syncs stay within the per-second limit before Gong rejects requests.
  • If Gong returns a 429, the connector waits for the interval in the Retry-After header, then retries. It doesn’t use a fixed back-off schedule.

The connector doesn’t pace requests against the 10,000-calls-per-day quota. A large backfill or frequent sync schedule can still exhaust it.

The call transcripts stream is a substream of the calls stream. From version 1.3.0, it batches up to 100 call IDs into each POST /v2/calls/transcript request. Previously, it sent one request per call. This sharply reduces request volume during large backfills. You’re then much less likely to reach Gong’s rate limit or daily quota. However, very large tenants can still approach these limits. Later incremental syncs only fetch transcripts for new calls.

IP allow list

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

Changelog

Expand to review
VersionDatePull RequestSubject
1.6.02026-11-0390976Add scorecards_review_method option to fetch AI-scored (AUTOMATIC) answered scorecards; defaults to MANUAL
1.5.72026-11-1091548Update dependencies
1.5.62026-11-0390575Update dependencies
1.5.52026-10-2784435Update external documentation URLs and enable autopilot rollouts
1.5.42026-10-2789913Update dependencies
1.5.32026-10-2089233Update dependencies
1.5.22026-10-1989089Add date-time format to start_date so the setup form renders a datepicker
1.5.12026-10-1388636Update dependencies
1.5.02026-10-0587006Fix extensiveCalls schema (parties[].context, media) and add missing reviewMethod and conferencingProviders fields
1.4.42026-10-0687873Update dependencies
1.4.32026-09-2987189Update dependencies
1.4.22026-09-2286644Update dependencies
1.4.12026-09-1586067Update dependencies
1.4.02026-08-3085192Promote connector to certified
1.3.62026-09-0885501Update dependencies
1.3.52026-08-1884600Update dependencies
1.3.42026-08-1183953Update dependencies
1.3.32026-08-0483474Update dependencies
1.3.22026-07-2882937Update dependencies
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
Advanced Analytica

Most businesses are sitting on information they can’t use at speed. The people who hold it are busy, and when they leave, the knowledge goes with them. The documents are static, and the processes around them weren’t designed for AI.

Advanced Analytica works with these businesses to turn that information into structured data assets. Once they're integrated, AI systems can govern it, and the business can use it. We bring in the strategy, the specification and the AI skills to rework how the business operates.

MOVE FAST. STAY SAFE.