Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Gong

Scalekit connector
Open markdown

The Gong connector lets your AI agent act in each user's Gong account. Each user signs in to Gong once, and Scalekit stores and refreshes their tokens, so your agent never handles credentials. It comes with 69 tools.

Tools
69
What they doRead · write · destructive
39 · 24 · 639 read24 write6 destructive
Users sign in with
OAuth app
Scalekit's or your own

Setup

  1. Install the SDK

    Terminal window
    npm install @scalekit-sdk/node dotenv

  2. Set your credentials

    Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

    .env
    SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
    SCALEKIT_CLIENT_ID=<your-client-id>
    SCALEKIT_CLIENT_SECRET=<your-client-secret>

  3. Create the Gong connection

    In AgentKit > Connections, create a Gong connection. The name you give it is the connection_name your code passes. See Configure connections.

    Scalekit credentials are available for Gong, so you don't need to register an OAuth app. To show your own app on the consent screen, use your own credentials instead.

    Use your own OAuth app

    Register your Scalekit environment with the Gong connector so Scalekit handles the authentication flow and token lifecycle for you. The connection name you create will be used to identify and invoke the connection programmatically. You’ll need your app credentials from the Gong Developer Portal.

    1. Set up auth redirects

      • In Scalekit dashboard, go to AgentKit > Connections > Create Connection.

      • Find Gong from the list of providers and click Create.

      • Click Use your own credentials and copy the redirect URI. It looks like https://<SCALEKIT_ENVIRONMENT_URL>/sso/v1/oauth/<CONNECTION_ID>/callback.

        Copy redirect URI from Scalekit dashboard

      • In the Gong Developer Portal, open your app.

      • Paste the copied URI into the Redirect URL field and click Save.

        Add redirect URL in Gong Developer Portal

    2. Get client credentials

      • In the Gong Developer Portal, open your app:
        • Client ID — listed under Client ID
        • Client Secret — listed under Client Secret

    3. Add credentials in Scalekit

      • In Scalekit dashboard, go to AgentKit > Connections and open the connection you created.

      • Enter your credentials:

        • Client ID (from your Gong app)
        • Client Secret (from your Gong app)
        • Permissions — select the scopes your app needs

        Add credentials in Scalekit dashboard

      • Click Save.

  4. Authorize a user and make your first call

    quickstart.mts
    import { ScalekitClient } from '@scalekit-sdk/node'
    import 'dotenv/config'
    import { createInterface } from 'node:readline/promises'
    

    const scalekit = new ScalekitClient(
      process.env.SCALEKIT_ENVIRONMENT_URL,
      process.env.SCALEKIT_CLIENT_ID,
      process.env.SCALEKIT_CLIENT_SECRET,
    )
    const actions = scalekit.actions
    

    const connector = 'gong'
    const identifier = 'user_123'
    

    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Gong:', link)
    const rl = createInterface({ input: process.stdin, output: process.stdout })
    await rl.question('Press Enter after authorizing...')
    rl.close()
    

    // Make your first call
    const result = await actions.executeTool({
      connector,
      identifier,
      toolName: 'gong_call_outcomes_list',
      toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each user signs in once. See Authorize a user for the full flow and statuses.

Tools

Pass the exact name to execute_tool
Try in PlaygroundRequest a tool
  • gong_call_getRetrieve basic data for a single Gong call by its ID: title, timing, direction, parties, and system/media info.Read-only

    Get Call

    Retrieve basic data for a single Gong call by its ID: title, timing, direction, parties, and system/media info. For richer data (trackers, topics, CRM associations, interaction stats) with filtering across many calls at once, use Get Calls (Extensive) instead.

    Inputs

    idstringrequired
    Gong's unique numeric identifier for the call (up to 20 digits).
  • gong_call_outcomes_listList all call outcome options configured in the Gong account.Read-only

    List Call Outcomes

    List all call outcome options configured in the Gong account. Returns outcome definitions such as name and ID that can be applied to calls to indicate the result of a conversation.

    Inputs

    This tool takes no inputs.

  • gong_call_users_access_getRetrieve the users who have been given individual access to specific calls through the Gong API (via Add Call Users Access).Read-only

    Get Call Users Access

    Retrieve the users who have been given individual access to specific calls through the Gong API (via Add Call Users Access). Does not report access granted through other means such as sharing, permission profiles, or team membership. Note: Gong implements this as a POST with a filter body even though it is a read-only lookup.

    Inputs

    call_idsarrayrequired
    Array of Gong's unique numeric call IDs to look up access for.
  • gong_calls_ai_content_getRetrieve Gong's AI-generated content for one or more calls, such as the call brief, key points, highlights, and outline.Read-only

    Get Call AI Content

    Retrieve Gong's AI-generated content for one or more calls, such as the call brief, key points, highlights, and outline. This is a separate, more focused endpoint than Get Calls (Extensive) for callers that only need the AI-generated summary content rather than full call metadata, parties, and interaction stats.

    Inputs

    call_idsarrayrequired
    Array of Gong call IDs to retrieve AI-generated content for.
    content_selectorarray
    Which AI-generated content types to include. Valid values: brief, outline, highlights, keyPoints, callSummary. Leave empty to return all available types.
    cursorstring
    Cursor value from a previous API response for paginating to the next page of results.
  • gong_calls_getRetrieve extensive details for one or more Gong calls by their IDs.Read-only

    Get Calls (Extensive)

    Retrieve extensive details for one or more Gong calls by their IDs. Returns enriched call data including participants, interaction stats, topics discussed, and CRM associations.

    Inputs

    call_idsarrayrequired
    Array of Gong call IDs to retrieve extensive details for.
    cursorstring
    Cursor value from a previous API response for paginating to the next page of results.
    from_date_timestring
    Start of the date-time range to filter calls (ISO 8601 format).
    include_mediaboolean
    Set to true to include signed audio and video recording URLs (media.audioUrl and media.videoUrl) for each call. The URLs expire after 8 hours. Gong returns recording URLs only through this endpoint, and the connected credentials need the api:calls:read:media-url scope. Defaults to false.default false
    to_date_timestring
    End of the date-time range to filter calls (ISO 8601 format).
    workspace_idstring
    Optional workspace ID to restrict the results to a specific Gong workspace.
  • gong_calls_listList Gong calls with optional filters for date range, workspace, and specific call IDs.Read-only

    List Calls

    List Gong calls with optional filters for date range, workspace, and specific call IDs. Returns a page of calls with metadata such as title, duration, participants, and direction.

    Inputs

    call_idsstring
    Comma-separated list of specific call IDs to retrieve.
    cursorstring
    Cursor value from a previous API response for paginating to the next page of results.
    from_date_timestring
    Start of the date-time range for filtering calls (ISO 8601 format, e.g., 2024-01-01T00:00:00Z).
    to_date_timestring
    End of the date-time range for filtering calls (ISO 8601 format, e.g., 2024-12-31T23:59:59Z).
    workspace_idstring
    Optional workspace ID to restrict results to a specific Gong workspace.
  • gong_calls_transcript_getRetrieve transcripts for one or more Gong calls by their IDs.Read-only

    Get Call Transcripts

    Retrieve transcripts for one or more Gong calls by their IDs. Returns speaker-attributed, sentence-level transcript segments with timing offsets for each call.

    Inputs

    call_idsarrayrequired
    Array of Gong call IDs whose transcripts to retrieve.
    cursorstring
    Cursor value from a previous API response for paginating to the next page of results.
    from_date_timestring
    Start of the date-time range to filter calls (ISO 8601 format).
    to_date_timestring
    End of the date-time range to filter calls (ISO 8601 format).
    workspace_idstring
    Optional workspace ID to restrict the results to a specific Gong workspace.
  • gong_coaching_getGet coaching data from Gong, including coaching sessions and feedback provided by managers to their team members.Read-only

    Get Coaching Data

    Get coaching data from Gong, including coaching sessions and feedback provided by managers to their team members. Supports cursor-based pagination for large result sets.

    Inputs

    cursorstring
    Cursor value from a previous response for paginating to the next page of results.

Workflows

Proxy API call
const result = await actions.request({
  connectionName: 'gong',
  identifier: 'user_123',
  path: '/v2/users',
  method: 'GET',
});
console.log(result);
Execute a tool
const result = await actions.executeTool({
  connector: 'gong',
  identifier: 'user_123',
  toolName: 'gong_call_outcomes_list',
  toolInput: {},
});
console.log(result);

Related: other CRM & Sales connectors

All 97 in CRM & Sales