# Gong

> Work with your Gong calls: get each call's brief, highlights and transcript, list calls and users, read activity, interaction and scorecard stats, add prospects to Engage flows, ask Gong AI about an account or deal, and handle privacy requests.

App · 23 actions. Web page: https://docs.lodol.com/docs/integrations/gong

## Actions

### Add call

Add a call recorded somewhere else, such as a dialer or phone system, to Gong. Gong downloads the recording from its link, then transcribes and analyses it like any other call.

**Inputs**

- Title (`title`, text): The call's title, shown and searchable in Gong.
- Host (`host_user_id`, text, required): The team member who made or took the call.
- Started (`started`, date and time, required): When the call started.
- Recording link (`recording_url`, text, required): A link Gong can download the audio or video from, up to 1.5 GB. It must be different for every call.
- Direction (`direction`, text): Who called whom. Defaults to outbound. One of: `Outbound` (Outbound (your team called them)), `Inbound` (Inbound (they called your team)), `Conference` (Conference call), `Unknown`. Default: `Outbound`.
- Length in seconds (`duration_seconds`, number): How long the call lasted. Gong works it out if left empty. At least 1.
- Other participants (`other_participants`, list): The email addresses or phone numbers of everyone else on the call.
- Purpose (`purpose`, text): What the call was for, up to 255 characters.
- Disposition (`disposition`, text): How the call ended, such as Left voicemail.
- Workspace (`workspace_id`, text): The workspace to put it in. Gong chooses one if left empty.
- Call id in your phone system (`call_reference`, text): The call's id where it was recorded. Gong won't add the same id twice. A new one is made up if left empty.

**Outputs**

- `call_id` (text): The new call's Gong id
- `call_reference` (text): The call's id in your phone system, as sent

**Example output**

```json
{
  "call_id": "7782342274025937896",
  "call_reference": "dialer-48213"
}
```

### Add prospects to a flow

Add up to 100 CRM contacts or leads to a Gong Engage flow, which then starts its emails, calls and tasks for them. Says which were added and why any weren't.

**Inputs**

- Flow owner (`owner_email`, text, required): The Gong user who owns the flow's to-dos. Their personal flows, flows shared with them and company flows are offered.
- Flow (`flow_id`, text, required): The flow to add them to.
- Prospect CRM ids (`prospect_crm_ids`, list, required): The CRM ids of the contacts or leads, as in Salesforce or HubSpot. Up to 100.

**Outputs**

- `assigned` (list): The prospects in flows
- `assigned_count` (number): How many were added
- `not_assigned` (list): The prospects that weren't added
- `not_assigned_count` (number): How many weren't

**Example output**

```json
{
  "assigned": [
    {
      "assigned": "2026-10-20T15:00:00Z",
      "flow_id": "1695493301223590792",
      "flow_instance_id": "1771234567890123456",
      "flow_name": "Inbound demo follow-up",
      "owner_email": "jon@example.com",
      "owner_name": "Jon Snow",
      "prospect_crm_id": "0035g00000XYZAB",
      "status": "Running",
      "workspace_id": "623457276584334"
    }
  ],
  "assigned_count": 1,
  "not_assigned": [
    {
      "error_code": "InvalidState",
      "error_message": "The prospect is already in an exclusive flow",
      "flow_id": "1695493301223590792",
      "prospect_crm_id": "00Q5g00000LMNOP"
    }
  ],
  "not_assigned_count": 1
}
```

### Ask about an account or deal

Ask Gong AI a question about a CRM account, deal, contact or lead, answered from its calls and emails, with the calls and emails it drew on. Uses Gong credits.

**Inputs**

- Workspace (`workspace_id`, text, required): The workspace whose calls and emails Gong reads.
- Record type (`record_type`, text, required): What kind of CRM record it is. One of: `ACCOUNT`, `DEAL` (Deal (opportunity)), `CONTACT`, `LEAD`.
- CRM record id (`record_id`, text, required): The record's id in your CRM, such as a Salesforce account id.
- Question (`question`, text, required): What you want to know.
- Calls and emails from (`time_period`, text): Which of the record's calls and emails Gong reads. One of: `LAST_90DAYS` (Last 90 days (default)), `LAST_7DAYS` (Last 7 days), `LAST_30DAYS` (Last 30 days), `LAST_YEAR` (Last year), `THIS_WEEK` (This week), `THIS_MONTH` (This month), `THIS_QUARTER` (This quarter), `THIS_YEAR` (This year), `LAST_90_DAYS_SINCE_LAST_ACTIVITY` (90 days up to the last activity), `LAST_YEAR_SINCE_LAST_ACTIVITY` (A year up to the last activity), `ALL_CONVERSATIONS` (All conversations), `CUSTOM_RANGE` (A range I choose). Default: `LAST_90DAYS`.
- From (`from_time`, date and time): The start of the range. Only when Calls and emails from is A range I choose.
- Until (`to_time`, date and time): The end of the range. Leave empty for up to now. Only when Calls and emails from is A range I choose.

**Outputs**

- `answer` (text): Gong's answer as text
- `answer_items` (list): The answer, part by part
- `calls_searched` (number): How many calls Gong read
- `emails_searched` (number): How many emails Gong read
- `source_calls` (list): The calls it drew on
- `source_emails` (list): The emails it drew on

**Example output**

```json
{
  "answer": "Security review timing is the main risk; procurement wants it done before March.",
  "answer_items": [
    "Security review timing is the main risk; procurement wants it done before March."
  ],
  "calls_searched": 4,
  "emails_searched": 11,
  "source_calls": [
    {
      "id": "7782342274025937895",
      "started": "2026-10-20T14:01:12Z",
      "title": "Discovery call with Acme",
      "url": "https://app.gong.io/call?id=7782342274025937895"
    }
  ],
  "source_emails": [
    {
      "id": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4",
      "sent": "2026-10-18T09:30:00Z",
      "subject": "Re: Security review"
    }
  ]
}
```

### Erase a person's data

Permanently delete from Gong every call, email message, contact and lead that names an email address, as for a privacy request. It can't be undone and takes a few hours to finish.

**Inputs**

- Email address (`email`, text, required): The person's email address. Calls they were on are deleted for everyone.

**Outputs**

- `email` (text): The address whose data is being erased
- `request_id` (text): Gong's reference for the request
- `requested` (true/false): True once Gong has taken the request

**Example output**

```json
{
  "email": "sam@acme.example",
  "request_id": "4al018gzaztcr8nbukw",
  "requested": true
}
```

### Find a person's data

Find every call, email message, meeting, CRM contact or lead and engagement event in Gong that names an email address, as for a privacy request.

**Inputs**

- Email address (`email`, text, required): The email address to look for.

**Outputs**

- `calls` (list): Calls that name it
- `crm_records` (list): CRM contacts and leads with the address
- `email` (text): The address looked for
- `emails` (list): Email messages to or from it
- `engagement` (list): Engagement events, such as viewing a shared call
- `found` (true/false): Whether Gong holds anything that names it
- `meeting_ids` (list): Meetings that name it

**Example output**

```json
{
  "calls": [
    {
      "id": "7782342274025937895",
      "status": "COMPLETED"
    }
  ],
  "crm_records": [
    {
      "crm_id": "0035g00000XYZAB",
      "id": "4455667788",
      "object_type": "Contact",
      "system": "Salesforce"
    }
  ],
  "email": "sam@acme.example",
  "emails": [
    {
      "from": "sam@acme.example",
      "id": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4",
      "mailbox": "jon@example.com",
      "sent": "2026-10-18T09:30:00Z"
    }
  ],
  "engagement": [
    {
      "content_url": "https://app.gong.io/e/c-share/abc",
      "event_name": "Viewed shared call",
      "event_type": "contentViewed",
      "happened": "2026-10-20T18:00:00Z"
    }
  ],
  "found": true,
  "meeting_ids": [
    "9988776655"
  ]
}
```

### Find user by email

Find the Gong user with an email address, including their other addresses. Says whether one was found rather than failing.

**Inputs**

- Email address (`email`, text, required): The email address to look for.

**Outputs**

- `found` (true/false): Whether a user has that address
- `user` (object): The user, or null when none has the address

**Example output**

```json
{
  "found": true,
  "user": {
    "active": true,
    "created": "2025-02-17T02:30:00-08:00",
    "email": "jon@example.com",
    "email_aliases": [
      "jon.snow@example.com"
    ],
    "first_name": "Jon",
    "id": "234599484848423",
    "last_name": "Snow",
    "manager_id": "563515258458745",
    "meeting_consent_page_url": "https://join.gong.io/example/jon.snow",
    "name": "Jon Snow",
    "phone_number": "+1 123-567-8989",
    "title": "Enterprise Account Executive"
  }
}
```

### Get account or deal brief

Have Gong AI write one of your company's briefs (set up in Gong's Agent Studio) for a CRM account, deal, contact or lead, from its calls and emails. Uses Gong credits.

**Inputs**

- Workspace (`workspace_id`, text, required): The workspace whose calls and emails Gong reads.
- Brief (`brief_name`, text, required): Which brief to write.
- Record type (`record_type`, text, required): What kind of CRM record it is. One of: `ACCOUNT`, `DEAL` (Deal (opportunity)), `CONTACT`, `LEAD`.
- CRM record id (`record_id`, text, required): The record's id in your CRM, such as a Salesforce account id.
- Calls and emails from (`time_period`, text): Which of the record's calls and emails Gong reads. One of: `LAST_90DAYS` (Last 90 days (default)), `LAST_7DAYS` (Last 7 days), `LAST_30DAYS` (Last 30 days), `LAST_YEAR` (Last year), `THIS_WEEK` (This week), `THIS_MONTH` (This month), `THIS_QUARTER` (This quarter), `THIS_YEAR` (This year), `LAST_90_DAYS_SINCE_LAST_ACTIVITY` (90 days up to the last activity), `LAST_YEAR_SINCE_LAST_ACTIVITY` (A year up to the last activity), `ALL_CONVERSATIONS` (All conversations), `CUSTOM_RANGE` (A range I choose). Default: `LAST_90DAYS`.
- From (`from_time`, date and time): The start of the range. Only when Calls and emails from is A range I choose.
- Until (`to_time`, date and time): The end of the range. Leave empty for up to now. Only when Calls and emails from is A range I choose.

**Outputs**

- `brief` (text): The whole brief as text, section by section
- `calls_searched` (number): How many calls Gong read
- `emails_searched` (number): How many emails Gong read
- `sections` (list): The brief's sections
- `source_calls` (list): The calls it drew on
- `source_emails` (list): The emails it drew on

**Example output**

```json
{
  "brief": "Deal status\nProcurement is reviewing security.",
  "calls_searched": 4,
  "emails_searched": 11,
  "sections": [
    {
      "source": "Conversations",
      "summary": [
        "Procurement is reviewing security."
      ],
      "title": "Deal status"
    }
  ],
  "source_calls": [
    {
      "id": "7782342274025937895",
      "started": "2026-10-20T14:01:12Z",
      "title": "Discovery call with Acme",
      "url": "https://app.gong.io/call?id=7782342274025937895"
    }
  ],
  "source_emails": [
    {
      "id": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4",
      "sent": "2026-10-18T09:30:00Z",
      "subject": "Re: Security review"
    }
  ]
}
```

### Get call

Get everything Gong knows about a call: who took part, Gong's brief, outline, highlights, key points and outcome, topics, trackers, talk time, comments, linked CRM records and links to the recording.

**Inputs**

- Call (`call_id`, text, required): The call's Gong id, from 'List calls' or the New call trigger. A link to the call in Gong works too.

**Outputs**

- `call` (object): The call, with everything Gong knows about it

**Example output**

```json
{
  "call": {
    "audio_url": "https://media.gong.io/audio/7782342274025937895",
    "brief": "Acme wants to replace its call recorder before renewal in March.",
    "calendar_event_id": "abcde@google.com",
    "client_unique_id": "",
    "comments": [
      {
        "at_second": 305,
        "comment": "Great discovery questions here.",
        "commenter_user_id": "563515258458745",
        "during_call": false,
        "id": "998877",
        "posted": "2026-10-20T16:00:00Z"
      }
    ],
    "crm_links": [
      {
        "fields": {
          "Name": "Acme expansion",
          "StageName": "Discovery"
        },
        "object_id": "0065g00000ABCDE",
        "object_type": "Opportunity",
        "system": "Salesforce"
      }
    ],
    "custom_data": "",
    "direction": "Conference",
    "duration": 1860,
    "highlights": [
      {
        "items": [
          "Send the security pack"
        ],
        "title": "Next steps"
      }
    ],
    "host_user_id": "234599484848423",
    "id": "7782342274025937895",
    "interaction_stats": [
      {
        "name": "Talk Ratio",
        "value": 0.41
      }
    ],
    "is_private": false,
    "key_points": [
      "Renewal is in March",
      "Security review needed"
    ],
    "language": "eng",
    "media": "Video",
    "meeting_url": "https://zoom.us/j/123",
    "outcome": "Next meeting scheduled",
    "outcome_category": "Positive",
    "outline": [
      {
        "duration": 180,
        "items": [
          "Sam runs operations for 40 reps"
        ],
        "section": "Introductions",
        "start_time": 0
      }
    ],
    "participants": [
      {
        "affiliation": "Internal",
        "email": "jon@example.com",
        "id": "56825452554556",
        "methods": [
          "Invitee",
          "Attendee"
        ],
        "name": "Jon Snow",
        "phone_number": "+1 123-567-8989",
        "speaker_id": "6432345678555530067",
        "title": "Enterprise Account Executive",
        "user_id": "234599484848423"
      },
      {
        "affiliation": "External",
        "email": "sam@acme.example",
        "id": "56825452554557",
        "methods": [
          "Attendee"
        ],
        "name": "Sam Tarly",
        "phone_number": "",
        "speaker_id": "6432345678555530068",
        "title": "Head of Operations",
        "user_id": ""
      }
    ],
    "purpose": "Discovery",
    "questions_by_company": 12,
    "questions_by_others": 5,
    "scheduled": "2026-10-20T14:00:00Z",
    "scope": "External",
    "sdr_disposition": "",
    "started": "2026-10-20T14:01:12Z",
    "system": "Zoom",
    "talk_time": [
      {
        "participant_id": "56825452554556",
        "seconds": 720,
        "user_id": "234599484848423"
      }
    ],
    "title": "Discovery call with Acme",
    "topics": [
      {
        "duration": 240,
        "name": "Pricing"
      }
    ],
    "trackers": [
      {
        "count": 3,
        "id": "6840000929075400007",
        "name": "Competitors",
        "type": "KEYWORD"
      }
    ],
    "url": "https://app.gong.io/call?id=7782342274025937895",
    "video_url": "https://media.gong.io/video/7782342274025937895",
    "workspace_id": "623457276584334"
  }
}
```

### Get call transcript

Get a call's transcript as readable text, each line naming who spoke and when, ready for an AI step. Each part is also given with its speaker, topic and timing.

**Inputs**

- Call (`call_id`, text, required): The call's Gong id, from 'List calls' or the New call trigger. A link to the call in Gong works too.

**Outputs**

- `call_id` (text): The call's Gong id
- `participants` (list): The people on the call
- `segments` (list): The transcript, turn by turn
- `text` (text): The whole transcript, one line per speaker turn
- `title` (text): The call's title
- `url` (text): The call's page in Gong

**Example output**

```json
{
  "call_id": "7782342274025937895",
  "participants": [
    {
      "affiliation": "Internal",
      "email": "jon@example.com",
      "id": "56825452554556",
      "methods": [
        "Invitee",
        "Attendee"
      ],
      "name": "Jon Snow",
      "phone_number": "+1 123-567-8989",
      "speaker_id": "6432345678555530067",
      "title": "Enterprise Account Executive",
      "user_id": "234599484848423"
    },
    {
      "affiliation": "External",
      "email": "sam@acme.example",
      "id": "56825452554557",
      "methods": [
        "Attendee"
      ],
      "name": "Sam Tarly",
      "phone_number": "",
      "speaker_id": "6432345678555530068",
      "title": "Head of Operations",
      "user_id": ""
    }
  ],
  "segments": [
    {
      "end_second": 3,
      "speaker_affiliation": "Internal",
      "speaker_email": "jon@example.com",
      "speaker_id": "6432345678555530067",
      "speaker_name": "Jon Snow",
      "start_second": 0,
      "text": "Thanks for making the time today.",
      "topic": "Call Setup"
    },
    {
      "end_second": 8,
      "speaker_affiliation": "External",
      "speaker_email": "sam@acme.example",
      "speaker_id": "6432345678555530068",
      "speaker_name": "Sam Tarly",
      "start_second": 4,
      "text": "Happy to. We're reviewing tools this quarter.",
      "topic": "Call Setup"
    }
  ],
  "text": "[00:00] Jon Snow: Thanks for making the time today.\n[00:04] Sam Tarly: Happy to. We're reviewing tools this quarter.",
  "title": "Discovery call with Acme",
  "url": "https://app.gong.io/call?id=7782342274025937895"
}
```

### Get interaction stats

For each user, get Gong's interaction stats between two dates: longest monologue, longest customer story, interactivity, patience and question rate.

**Inputs**

- From (`from_date`, date, required): The first day to count, in your company's time zone in Gong.
- Until (`to_date`, date, required): The day to stop at, which is not counted. It can be today at the latest.
- Users (`user_ids`, list): Only these users. Leave empty for everyone with activity.
- Next page cursor (`cursor`, text): The 'next_cursor' from an earlier page, to get the page after it.

**Outputs**

- `count` (number): How many came back
- `next_cursor` (text): Pass this as 'Next page cursor' to get the next page; empty on the last
- `time_zone` (text): Your company's time zone in Gong, which the days use
- `total` (number): How many there are in all, across every page
- `users` (list): One entry per user

**Example output**

```json
{
  "count": 1,
  "next_cursor": "",
  "time_zone": "America/New_York",
  "total": 1,
  "users": [
    {
      "stats": [
        {
          "name": "Longest Monologue",
          "value": 142
        },
        {
          "name": "Patience",
          "value": 0.9
        }
      ],
      "user_email": "jon@example.com",
      "user_id": "234599484848423"
    }
  ]
}
```

### Get user

Get one Gong user with their email, title and manager.

**Inputs**

- User (`gong_user_id`, text, required): The Gong user. Pick one, or give their Gong user id.

**Outputs**

- `user` (object): A Gong user

**Example output**

```json
{
  "user": {
    "active": true,
    "created": "2025-02-17T02:30:00-08:00",
    "email": "jon@example.com",
    "email_aliases": [
      "jon.snow@example.com"
    ],
    "first_name": "Jon",
    "id": "234599484848423",
    "last_name": "Snow",
    "manager_id": "563515258458745",
    "meeting_consent_page_url": "https://join.gong.io/example/jon.snow",
    "name": "Jon Snow",
    "phone_number": "+1 123-567-8989",
    "title": "Enterprise Account Executive"
  }
}
```

### Get user activity stats

For each user, count the calls they hosted and attended, listened to, shared, commented on, gave feedback on and scored, between two dates.

**Inputs**

- From (`from_date`, date, required): The first day to count, in your company's time zone in Gong.
- Until (`to_date`, date, required): The day to stop at, which is not counted. It can be today at the latest.
- Users (`user_ids`, list): Only these users. Leave empty for everyone with activity.
- Next page cursor (`cursor`, text): The 'next_cursor' from an earlier page, to get the page after it.

**Outputs**

- `count` (number): How many came back
- `next_cursor` (text): Pass this as 'Next page cursor' to get the next page; empty on the last
- `time_zone` (text): Your company's time zone in Gong, which the days use
- `total` (number): How many there are in all, across every page
- `users` (list): One entry per user with activity

**Example output**

```json
{
  "count": 1,
  "next_cursor": "",
  "time_zone": "America/New_York",
  "total": 1,
  "users": [
    {
      "calls_as_host": 20,
      "calls_attended": 46,
      "calls_comments_given": 9,
      "calls_comments_received": 6,
      "calls_gave_feedback": 7,
      "calls_marked_as_feedback_given": 2,
      "calls_marked_as_feedback_received": 4,
      "calls_received_feedback": 5,
      "calls_requested_feedback": 2,
      "calls_scorecards_filled": 3,
      "calls_scorecards_received": 8,
      "calls_shared_externally": 1,
      "calls_shared_internally": 4,
      "others_calls_listened_to": 31,
      "own_calls_listened_to": 12,
      "user_email": "jon@example.com",
      "user_id": "234599484848423"
    }
  ]
}
```

### List a prospect's flows

List the open flows (pending, running or paused) that CRM contacts or leads are in.

**Inputs**

- Prospect CRM ids (`prospect_crm_ids`, list, required): The CRM ids of the contacts or leads, as in Salesforce or HubSpot. Up to 100.

**Outputs**

- `count` (number): How many came back
- `flows` (list): The prospects in flows

**Example output**

```json
{
  "count": 1,
  "flows": [
    {
      "assigned": "2026-10-20T15:00:00Z",
      "flow_id": "1695493301223590792",
      "flow_instance_id": "1771234567890123456",
      "flow_name": "Inbound demo follow-up",
      "owner_email": "jon@example.com",
      "owner_name": "Jon Snow",
      "prospect_crm_id": "0035g00000XYZAB",
      "status": "Running",
      "workspace_id": "623457276584334"
    }
  ]
}
```

### List answered scorecards

List the scorecards filled in for calls, with every answer and score. Filter by call dates, scorecard, the person reviewed, and whether a person or Gong AI filled them in.

**Inputs**

- Calls from (`from_date`, date): Only calls on or after this day. Leave empty for the earliest.
- Calls until (`to_date`, date): Only calls before this day. Leave empty for up to now.
- Scorecards (`scorecard_ids`, list): Only these scorecards. Leave empty for all of them.
- Reviewed users (`reviewed_user_ids`, list): Only scorecards on these users' calls.
- Filled in by (`review_method`, text): Who filled the scorecards in. Defaults to a person. One of: `MANUAL` (Filled in by a person (default)), `AUTOMATIC` (Filled in by Gong AI), `BOTH`. Default: `MANUAL`.
- Next page cursor (`cursor`, text): The 'next_cursor' from an earlier page, to get the page after it.

**Outputs**

- `answered_scorecards` (list): The filled-in scorecards
- `count` (number): How many came back
- `next_cursor` (text): Pass this as 'Next page cursor' to get the next page; empty on the last
- `total` (number): How many there are in all, across every page

**Example output**

```json
{
  "answered_scorecards": [
    {
      "answers": [
        {
          "answer_text": "Strong discovery.",
          "is_overall": true,
          "not_applicable": false,
          "question_id": "1001",
          "score": 4
        }
      ],
      "call_id": "7782342274025937895",
      "call_started": "2026-10-20T14:01:12Z",
      "id": "563515258458745",
      "review_method": "MANUAL",
      "reviewed_at": "2026-10-21T10:00:00Z",
      "reviewed_user_id": "234599484848423",
      "reviewer_user_id": "563515258458745",
      "scorecard_id": "6843152929075440037",
      "scorecard_name": "SDR Call Scorecard",
      "visibility": "PUBLIC"
    }
  ],
  "count": 1,
  "next_cursor": "",
  "total": 1
}
```

### List calls

List recorded calls, oldest first, with who took part in each. Filter by when they started, workspace or host. Returns up to 100; to see more, run it again with the next page it gives.

**Inputs**

- Started on or after (`from_time`, date and time): Only calls that started at or after this time.
- Started before (`to_time`, date and time): Only calls that started before this time.
- Workspace (`workspace_id`, text): Only this workspace. Leave empty for every workspace.
- Hosted by (`host_user_ids`, list): Only calls these users hosted. Leave empty for anyone's.
- Next page cursor (`cursor`, text): The 'next_cursor' from an earlier page, to get the page after it.

**Outputs**

- `calls` (list): The calls, each with its participants
- `count` (number): How many came back
- `next_cursor` (text): Pass this as 'Next page cursor' to get the next page; empty on the last
- `total` (number): How many there are in all, across every page

**Example output**

```json
{
  "calls": [
    {
      "calendar_event_id": "abcde@google.com",
      "client_unique_id": "",
      "custom_data": "",
      "direction": "Conference",
      "duration": 1860,
      "host_user_id": "234599484848423",
      "id": "7782342274025937895",
      "is_private": false,
      "language": "eng",
      "media": "Video",
      "meeting_url": "https://zoom.us/j/123",
      "participants": [
        {
          "affiliation": "Internal",
          "email": "jon@example.com",
          "id": "56825452554556",
          "methods": [
            "Invitee",
            "Attendee"
          ],
          "name": "Jon Snow",
          "phone_number": "+1 123-567-8989",
          "speaker_id": "6432345678555530067",
          "title": "Enterprise Account Executive",
          "user_id": "234599484848423"
        },
        {
          "affiliation": "External",
          "email": "sam@acme.example",
          "id": "56825452554557",
          "methods": [
            "Attendee"
          ],
          "name": "Sam Tarly",
          "phone_number": "",
          "speaker_id": "6432345678555530068",
          "title": "Head of Operations",
          "user_id": ""
        }
      ],
      "purpose": "Discovery",
      "scheduled": "2026-10-20T14:00:00Z",
      "scope": "External",
      "sdr_disposition": "",
      "started": "2026-10-20T14:01:12Z",
      "system": "Zoom",
      "title": "Discovery call with Acme",
      "url": "https://app.gong.io/call?id=7782342274025937895",
      "workspace_id": "623457276584334"
    }
  ],
  "count": 1,
  "next_cursor": "",
  "total": 1
}
```

### List calls in a library folder

List the calls saved in a library folder, with the note and the snippet saved with each.

**Inputs**

- Folder (`folder_id`, text, required): The library folder. Pick one, or give its id.

**Outputs**

- `calls` (list): The calls in it
- `count` (number): How many came back
- `folder_id` (text): The folder's id
- `folder_name` (text): The folder's name

**Example output**

```json
{
  "calls": [
    {
      "added": "2026-10-21T09:00:00Z",
      "added_by": "234599484848423",
      "id": "7782342274025937895",
      "note": "Great example of discovery",
      "snippet_end_second": 900,
      "snippet_start_second": 305,
      "title": "Discovery call with Acme",
      "url": "https://app.gong.io/call?id=7782342274025937895"
    }
  ],
  "count": 1,
  "folder_id": "3843152912968920037",
  "folder_name": "Sales Onboarding"
}
```

### List flows

List the Gong Engage flows a user can add prospects to: company flows, their personal flows and those shared with them.

**Inputs**

- Flow owner (`owner_email`, text, required): The Gong user who owns the flow's to-dos. Their personal flows, flows shared with them and company flows are offered.
- Workspace (`workspace_id`, text): Only this workspace. Leave empty for every workspace.
- Next page cursor (`cursor`, text): The 'next_cursor' from an earlier page, to get the page after it.

**Outputs**

- `count` (number): How many came back
- `flows` (list): The flows
- `next_cursor` (text): Pass this as 'Next page cursor' to get the next page; empty on the last
- `total` (number): How many there are in all, across every page

**Example output**

```json
{
  "count": 1,
  "flows": [
    {
      "created": "2026-02-17T02:30:00-08:00",
      "exclusive": true,
      "folder_id": "1695493301223573465",
      "folder_name": "Inbound",
      "id": "1695493301223590792",
      "name": "Inbound demo follow-up",
      "visibility": "Company"
    }
  ],
  "next_cursor": "",
  "total": 1
}
```

### List keyword trackers

List the keyword trackers Gong listens for in calls, such as competitor names, with their words and phrases.

**Inputs**

- Workspace (`workspace_id`, text): Only this workspace. Leave empty for every workspace.

**Outputs**

- `count` (number): How many came back
- `trackers` (list): The keyword trackers

**Example output**

```json
{
  "count": 1,
  "trackers": [
    {
      "affiliation": "NonCompany",
      "created": "2025-02-17T10:30:00Z",
      "id": "6840000929075400007",
      "keywords": [
        "Chorus",
        "Clari"
      ],
      "name": "Competitors",
      "part_of_question": false,
      "said_at": "Anytime",
      "updated": "2025-02-17T10:30:00Z",
      "workspace_id": "623457276584334"
    }
  ]
}
```

### List library folders

List the public folders of Gong's call library, where teams keep example calls. Private and archived folders aren't included.

**Inputs**

- Workspace (`workspace_id`, text): Only this workspace. Leave empty for every workspace.

**Outputs**

- `count` (number): How many came back
- `folders` (list): The folders

**Example output**

```json
{
  "count": 1,
  "folders": [
    {
      "created_by": "234599484848423",
      "id": "3843152912968920037",
      "name": "Sales Onboarding",
      "parent_folder_id": "",
      "updated": "2026-03-14T05:30:00-08:00"
    }
  ]
}
```

### List scorecards

List the company's scorecards with their questions and the answers each question offers.

**Inputs**: None.

**Outputs**

- `count` (number): How many came back
- `scorecards` (list): The scorecards

**Example output**

```json
{
  "count": 1,
  "scorecards": [
    {
      "created": "2025-02-17T10:30:00Z",
      "enabled": true,
      "id": "6843152929075440037",
      "name": "SDR Call Scorecard",
      "questions": [
        {
          "answer_options": [],
          "id": "1001",
          "is_overall": true,
          "text": "How well did the rep run discovery?",
          "type": "RANGE"
        }
      ],
      "review_method": "MANUAL",
      "updated": "2025-03-01T08:00:00Z",
      "workspace_id": "623457276584334"
    }
  ]
}
```

### List users

List the company's Gong users with their email, title, manager and whether they are active. Returns up to 100; to see more, run it again with the next page it gives.

**Inputs**

- Next page cursor (`cursor`, text): The 'next_cursor' from an earlier page, to get the page after it.

**Outputs**

- `count` (number): How many came back
- `next_cursor` (text): Pass this as 'Next page cursor' to get the next page; empty on the last
- `total` (number): How many there are in all, across every page
- `users` (list): The users

**Example output**

```json
{
  "count": 1,
  "next_cursor": "",
  "total": 1,
  "users": [
    {
      "active": true,
      "created": "2025-02-17T02:30:00-08:00",
      "email": "jon@example.com",
      "email_aliases": [
        "jon.snow@example.com"
      ],
      "first_name": "Jon",
      "id": "234599484848423",
      "last_name": "Snow",
      "manager_id": "563515258458745",
      "meeting_consent_page_url": "https://join.gong.io/example/jon.snow",
      "name": "Jon Snow",
      "phone_number": "+1 123-567-8989",
      "title": "Enterprise Account Executive"
    }
  ]
}
```

### List workspaces

List the company's Gong workspaces.

**Inputs**: None.

**Outputs**

- `count` (number): How many came back
- `workspaces` (list): The workspaces

**Example output**

```json
{
  "count": 1,
  "workspaces": [
    {
      "description": "The sales team's calls",
      "id": "623457276584334",
      "name": "Sales"
    }
  ]
}
```

### Remove a prospect from flows

Take a CRM contact or lead out of one flow, or out of every flow they are in, stopping its emails, calls and tasks for them.

**Inputs**

- Prospect CRM id (`prospect_crm_id`, text, required): The contact's or lead's id in your CRM.
- Flow (`flow_id`, text): Only this flow's id, from 'List a prospect's flows'. Leave empty to remove them from every flow.
- Removed by (`removed_by_email`, text): The Gong user to record as removing them.

**Outputs**

- `count` (number): How many flows they were taken out of
- `prospect_crm_id` (text): The prospect's CRM id
- `removed_flow_instance_ids` (list): The flow runs they were taken out of

**Example output**

```json
{
  "count": 1,
  "prospect_crm_id": "0035g00000XYZAB",
  "removed_flow_instance_ids": [
    "1771234567890123456"
  ]
}
```
