View as Markdown
Gong icon

Gong ACTION

Search Calls

Search calls and return their metadata together with whichever detail sections you ask for: the AI call brief (summary), key points, outline (which contains the next steps), highlights, call outcome, topics, keyword tracker hits, participants, interaction stats, and linked CRM records such as the account and deal. This is the tool for questions like "what happened on last quarter's calls", "what were the next steps", or "which deals do these calls belong to". Brief, key points, outline, highlights, and call outcome come from Gong's Spotlight AI. They are silently omitted for calls Gong has not generated them for (very short calls, calls without a transcript, or workspaces without the feature). See the documentation
  • Action
  • Read only
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Gong account once, then configure and run Search Calls from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "gong-get-extensive-data",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    gong: { authProvisionId: "apn_xxxxxxx" },
    fromDateTime: "From Date Time",
    toDateTime: "To Date Time",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Search Calls inputs
Property Type Description
fromDateTime From Date Time string
Only return calls that started on or after this date and time, in ISO-8601 format (e.g. 2026-01-01T00:00:00Z). Omit to start from the earliest call.
Optional
toDateTime To Date Time string
Only return calls that started before this date and time, in ISO-8601 format (e.g. 2026-04-01T00:00:00Z). The bound is exclusive. Omit to end at the most recent call.
Optional
workspaceId Workspace ID string
Return only calls belonging to this workspace. Cannot be combined with Call IDs. Use the List Workspace ID Options action to discover workspace IDs.
Optional Dynamic
callIds Call IDs string[]
Return only these calls. Pass a single ID to fetch one call. Cannot be combined with Workspace ID. Use List Calls to discover call IDs.
Optional Dynamic
primaryUserIds Primary User IDs string[]
Return only calls hosted by these Gong users, matched against each call's primaryUserId. This is how you find a given rep's calls. Use the List Users action to discover user IDs.
Optional Dynamic
content Content string[]
Which call-content sections to return. Defaults to the insight fields (brief, key points, outline, highlights, call outcome, topics). Select Tracker Occurrences only together with Trackers.
Optional
interaction Interaction Stats string[]
Which interaction statistics to return, such as per-speaker talk time and talk ratio. Omit for none.
Optional
includeParties Include Parties boolean
Whether to return the call's participants (name, email, affiliation as Internal or External, speakerId, and any linked CRM contact). Needed to attribute transcript speakers to people.
Optional
context CRM Context string
How much external-system (CRM, telephony, case management) data to attach to each call and party. Set to Extended to get account and deal field values.
Optional
contextTiming Context Timing string[]
Whether CRM values should reflect their state now, at the time of the call, or both. Only valid when CRM Context is Extended. Defaults to Now.
Optional
includePublicComments Include Public Comments boolean
Whether to return public comments left on the call in Gong.
Optional
includeMedia Include Media URLs boolean
Whether to return audio and video download URLs. Requires the api:calls:read:media-url scope; the URLs are short-lived.
Optional
limit Limit integer
Maximum number of calls to return. Min 1, max 1000.
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
gong-get-extensive-data
Version
1.0.0
App
Gong
Authentication
OAuth
Read-only
Yes
Destructive
No
Open world
Yes