View as Markdown
Gong icon

Gong ACTION

List Users

List the Gong users in your company and return an array of user objects. Gong cannot search users by name or email, so to resolve a rep to their user ID, list users and match the returned firstName/lastName/emailAddress fields yourself; that ID is what Search Calls needs for Primary User IDs. Pass a single value in User IDs to fetch one known user. Gong has no teams endpoint: set Manager ID to list that manager's direct reports, filtered here rather than by the API. Returns at most Limit users. See the documentation
  • Action
  • Read only
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Gong account once, then configure and run List Users 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-list-users",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    gong: { authProvisionId: "apn_xxxxxxx" },
    userIds: ["User IDs"],
    managerId: "Manager ID",
  },
})

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.

List Users inputs
Property Type Description
userIds User IDs string[]
Return only these users, as a list of Gong user IDs (e.g. ["4011503062935085673"]). Pass a single ID to fetch one user.
Optional Dynamic
managerId Manager ID string
Return only users whose managerId matches this Gong user ID (the id field of the manager's own user record, e.g. 4011503062935085673), which is how you list a manager's team. Applied here after fetching, not by the Gong API.
Optional Dynamic
createdFromDateTime Created From Date Time string
Return only users created on or after this date and time, in ISO-8601 format (e.g. 2026-01-01T00:00:00Z).
Optional
createdToDateTime Created To Date Time string
Return only users created before this date and time, in ISO-8601 format (e.g. 2026-04-01T00:00:00Z).
Optional
includeAvatars Include Avatars boolean
Whether to include avatars, the synthetic users that represent Gong employees accessing your instance. Off by default because they are rarely what you want.
Optional
limit Limit integer
Maximum number of users 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-list-users
Version
0.0.1
App
Gong
Authentication
OAuth
Read-only
Yes
Destructive
No
Open world
Yes