Gong

Tools

• Add call media v2 calls id media

  Adds a call media, recorded by a telephony system (pbx) or other media recording facility. gong accepts call recordings in various audio and video file formats, including wav, mp3, mp4, mkv and flac. if uploading a dual-channel (stereo) fil

• Add new call v2 calls

  When using this endpoint, either provide a downloadmediaurl or use the returned callid in a follow-up request to /v2/calls/{id}/media to upload the media file. when accessed through a bearer token authorization method, this endpoint require

• Aggregate activity by period via api

  Lists the aggregated activity of multiple users within the gong system for each time period within the defined date range. this endpoint returns multiple records, one for each user. for each user there are items for every time period in the

• Aggregate user activity statistics

  Lists the activity of multiple users within the gong system during a defined period. given the period, this endpoint returns multiple records, one for each user, with an applicable activity during the period. each record includes statistics

• Assign prospects to flow

  Use this endpoint to assign a number of prospects to a flow. prospects can be contacts or leads in your crm. generate a list of comma separated crm ids of the prospects you want to add to a flow. the flowinstanceowneremail parameter is the

• Create activity scorecards report

  Retrieve all the answers for the scorecards that were reviewed during a specified date range, for calls that took place during a specified date range, for specific scorecards or for specific reviewed users. when accessed through a bearer to

• Create a new gong meeting v2 meetings

  When accessed through a bearer token authorization method, this endpoint requires the scope 'api:meetings:user:create'.

• Create permission profile v2 permission profile

  Create a permission profile in a given workspace.

• Data privacy for phone number

  Shows the elements in the gong system that reference the given phone number. given a phone number, this endpoint returns details of any leads or contacts with this phone number and their associated calls and email messages. when accessed th

• Delete a generic crm integration v2 crm integrations

  destructive

  Deletes an existing crm integration from the gong platform. this endpoint should be used when you want to disconnect or remove a previously established integration between gong and a crm system, such as hubspot. it's particularly useful whe

• Delete a gong meeting v2 meetings

  destructive

  When accessed through a bearer token authorization method, this endpoint requires the scope 'api:meetings:user:delete'.

• Delete users from call access list

  destructive

  Remove individual user access from calls. the request can only remove access previously given by the /v2/calls/users-access api. if a given user does not have access to the call, they will be unaffected. if a given user does have access to

• Erase data for email address

  Given an email address, this endpoint deletes from the gong system any calls or email messages that reference this address. email messages sent to or from the address are deleted. calls where the email address appears (as a lead, contact, a

• Erase data for phone number

  Given a phone number, this endpoint deletes from the gong system any leads or contacts with a matching phone number or mobile phone number. email messages sent to or from these leads/contacts are deleted. calls where the leads/contacts appe

• Fetch all permission profiles

  Returns a list of all permission profiles. the listing is in the alphabetical order of the profile names.

• Get Crm Integration Details

  <style>.public-api-info { background: rgb(222, 235, 255);}.public-api-tip { background: rgb(227, 252, 239);}.public-api-parameter { background: rgba(9,30,66,0.08);}.public-api-note { background: rgb(234, 230, 255);}.public-api-important { b

• Get crm objects v2 crm entities

  Retrieves crm entities from the gong platform. this endpoint allows users to fetch various crm objects such as accounts, deals, and contacts that have been integrated with gong's revenue intelligence system. it provides a way to access and

• Get permission profile

  Returns a permission profile.

• Get request status v2 crm request status

  The getcrmrequeststatus endpoint retrieves the current status of crm integration requests in the gong platform. it allows users to check the progress and outcome of operations related to crm data uploads, synchronization, or other crm-relat

• List all coaching metrics v2 coaching

  List all of the coaching metrics of a manager. when accessed through a bearer token authorization method, this endpoint requires the scope 'api:coaching:read'.

• List all company workspaces v2 workspaces

  Returns a list of all workspaces including their details. when accessed through a bearer token authorization method, this endpoint requires the scope 'api:workspaces:read'.

• List all users v2 users

  List all of the company's users. when accessed through a bearer token authorization method, this endpoint requires the scope 'api:users:read'.

• List flows for crm prospects

  Get the gong engage flows assigned to the given prospects. when accessed through a bearer token authorization method, this endpoint requires the scope 'api:flows:read'.

• List Folder Calls

  Given a folder id, this endpoint retrieves a list of calls in it. when accessed through a bearer token authorization method, this endpoint requires the scope 'api:library:read'.

• List gong engage flows v2 flows

  Engage flows have the following visibility types: * company: visible to everyone in the company, can only be edited by users with edit permissions. * personal: reps can set up their own flows which are only available to them. * shared: reps

• List schema fields v2 crm entity schema

  Retrieves the comprehensive schema of crm entities in the gong platform. this endpoint provides detailed metadata about the structure, attributes, and relationships of entities within the customer relationship management (crm) system. it is

• List users by filter v2 users extensive

  List multiple users. when accessed through a bearer token authorization method, this endpoint requires the scope 'api:users:read'.

• Manage user call access

  Returns a list of users who have received individual access to calls through the api. this endpoint doesn't cover user that have access for other reasons (such as sharing recipients, or access through permission profiles). when accessed thr

• Post a digital interaction v2 digital interaction

  When accessed through a bearer token authorization method, this endpoint requires the scope 'api:digital-interactions:write'.

• Post day by day activity stats

  Retrieve the daily activity of multiple users within the gong system for a range of dates. this endpoint returns records including statistics about each user's activity, on the daily level. records are returned only for users with activity

• Post interaction filter stats

  Returns interaction stats for users based on calls that have whisper turned on. when accessed through a bearer token authorization method, this endpoint requires the scope 'api:stats:interaction'.

• Post meeting integration status

  When accessed through a bearer token authorization method, this endpoint requires the scope 'api:meetings:integration:status'.

• Register Crm Integration

  Updates an existing crm integration in the gong platform. this endpoint allows you to modify the details of a previously set up integration between gong and your customer relationship management (crm) system. it's primarily used for changin

• Report content viewed event

  Push engagement events into gong and display them as events in gong’s activity timeline, when a content is viewed by an external participant (for example, a contract was “viewed” by the prospect) when accessed through a bearer token authori

• Report Custom Engagement Event

  Push engagement events into gong and display them as events in gong’s activity timeline, when a content is engaged by an external participant (for example, a contract was “signed” by the prospect) when accessed through a bearer token author

• Retrieve call data by date range v2 calls

  List calls that took place during a specified date range. when accessed through a bearer token authorization method, this endpoint requires the scope 'api:calls:read:basic'.

• Retrieve data for a specific call v2 calls id

  Retrieve data for a specific call. when accessed through a bearer token authorization method, this endpoint requires the scope 'api:calls:read:basic'.

• Retrieve data privacy info for email address

  Shows the elements in the gong system that reference the given email address. given an emails address, this endpoint returns details of all calls and email messages that reference this address, and any leads or contacts with this email addr

• Retrieve filtered call details

  Lists detailed call data for calls that took place during a specified date range, have specified call ids or hosted by specified users. when accessed through a bearer token authorization method, this endpoint requires the scope 'api:calls:r

• Retrieve library folders v2 library folders

  Use this endpoint to retrieve a list of public library folders. we do not allow retrieval of either private or archived folders. when accessed through a bearer token authorization method, this endpoint requires the scope 'api:library:read'.

• Retrieve logs data by type and time range v2 logs

  List log entries that took place during a specified time range. when accessed through a bearer token authorization method, this endpoint requires the scope 'api:logs:read'.

• Retrieve manual crm call associations

  Returns a list of all calls that were manually associated or re-associated with crm account and deal/opportunity since a given time. actions will be listed in the ascending order of their timing. notice if a call was associated and later re

• Retrieve scorecards details v2 settings scorecards

  Retrieve all the scorecards within the gong system. when accessed through a bearer token authorization method, this endpoint requires the scope 'api:settings:scorecards:read'.

• Retrieve tracker details v2 settings trackers

  Retrieves details of all keyword trackers in the system or in a given workspace. when accessed through a bearer token authorization method, this endpoint requires the 'api:settings:trackers:read' scope.

• Retrieve transcripts of calls v2 calls transcript

  Returns transcripts for calls that took place during the specified date period. if call ids are specified, only transcripts for calls with those ids that took place during the time period are returned. when accessed through a bearer token a

• Retrieve User Settings History

  Retrieve a specific user's settings history. when accessed through a bearer token authorization method, this endpoint requires the scope 'api:users:read'.

• Retrieve users from permission profile

  Returns a list of all users whose access is controlled by the given permission profile. when accessed through a bearer token authorization method, this endpoint requires the scope 'api:users:read'.

• Retrieve user v2 users id

  Retrieve a specific user. when accessed through a bearer token authorization method, this endpoint requires the scope 'api:users:read'.

• Set User Call Access

  Give individual users access to calls. if a user already has access (perhaps the call was shared with them, or they have access through their permission profiles) the request will have no effect. when accessed through a bearer token authori

• Update a gong meeting v2 meetings meetingid

  When accessed through a bearer token authorization method, this endpoint requires the scope 'api:meetings:user:update'.

Works well with

How Switchy teams use it

Starter prompts

@Gong list the five most recent calls from the past week, then summarize the main topics discussed in each and flag any mentions of pricing or competitors.

@Gong create an activity scorecards report for calls between March 1 and March 15, then show me which reps scored below 70% on objection handling.

@Gong aggregate user activity statistics for the last 30 days and list each rep's total calls, average call duration, and number of days active.

@Gong add a new call with download media URL https://example.com/call-recording.mp3, title 'Discovery Call - Acme Corp', and participant emails sales@mycompany.com and contact@acmecorp.com.

@Gong create a new meeting for April 10 at 3pm EST with title 'Q2 Business Review - BigCo' and invitees john@mycompany.com, sarah@mycompany.com, buyer@bigco.com.

Example outputs

Illustrative - representative of the model's voice and quality, not literal recordings.

Use-case deep-dives

Frequently asked