Access Token

Refresh Token

Gong

The actual date and time when the call started in the ISO-8601 format (e.g., '2018-02-18T02:30:00-07:00' or '2018-02-18T08:00:00Z', where Z stands for UTC);

The Id of the meeting in Google or Outlook Calendar.

The code identifies the provider conferencing or telephony system. For example: zoom, clearslide, gotomeeting, ringcentral, outreach, insidesales, etc. These values are predefined by Gong, please contact help@gong.io to find the proper value for your system.

A call's unique identifier in the PBX or the recording system. Gong uses this identifier to prevent repeated attempts to upload the same recording.

A list of references to external systems such as CRM, Telephony System, Case Management, etc.

Links to external systems such as CRM, Telephony System, Case Management etc. Currently only Salesforce and Generic are supported.

List of objects within the external system. Note: Multiple opportunities/deals belonging to the same account are not supported.

External system name. Currently only Salesforce and Generic are supported.

Optional metadata associated with the call (represented as text). Gong stores this metadata and it can be used for troubleshooting.

Whether the call is inbound (someone called the company), outbound (a rep dialed someone outside the company), or a conference call.

The disposition of the call. The disposition is free text of up to 255 characters.

The URL from which Gong can download the media file.
The URL must be unique, the audio or video file must be a maximum of 1.5GB.
If you provide this URL, you should not perform the 'Add call media' step.

Gong's unique numeric identifier for the call (up to 20 digits).

The language codes (as defined by ISO-639-2B). E.g., eng, fre, spa, ger, and ita. Also used are und (unsupported language), and zxx (not enough speech content for identification).

The language code the call should be transcribed to.
This field is optional as Gong automatically detects the language spoken in the call and transcribes it accordingly. Set this field only if you are sure of the language the call is in.
Valid values are: af-ZA, am-ET, ar-AE, ar-BH, ar-DZ, ar-EG, ar-IL, ar-IQ, ar-JO, ar-KW, ar-LB, ar-MA, ar-MR, ar-OM, ar-PS, ar-QA, ar-SA, ar-TN, ar-YE, az-AZ, bg-BG, bn-BD, bn-IN, bs-BA, ca-ES, cs-CZ, da-DK, de-AT, de-CH, de-DE, el-GR, en-AB, en-AU, en-CA, en-GB, en-IE, en-IN, en-NZ, en-PH, en-SG, en-US, en-WL, en-ZA, es-AR, es-BO, es-CL, es-CO, es-CR, es-DO, es-EC, es-ES, es-GT, es-HN, es-MX, es-NI, es-PA, es-PE, es-PR, es-PY, es-SV, es-US, es-UY, et-EE, eu-ES, fa-IR, fi-FI, fil-PH, fr-BE, fr-CA, fr-CH, fr-FR, gl-ES, gu-IN, he-IL, hi-IN, hr-HR, hu-HU, hy-AM, id-ID, is-IS, it-CH, it-IT, ja-JP, jv-ID, ka-GE, kk-KZ, km-KH, kn-IN, ko-KR, lo-LA, lt-LT, lv-LV, mk-MK, ml-IN, mn-MN, mr-IN, ms-MY, my-MM, ne-NP, nl-BE, nl-NL, no-NO, pa-Guru-IN, pl-PL, pt-BR, pt-PT, ro-RO, ru-RU, si-LK, sk-SK, sl-SI, sq-AL, sr-RS, su-ID, sv-SE, sw-KE, sw-TZ, ta-IN, ta-LK, ta-MY, ta-SG, te-IN, th-TH, tr-TR, uk-UA, ur-IN, ur-PK, uz-UZ, vi-VN, yue-Hant-HK, zh-CN, zh-TW, zu-ZA

The URL of the conference call by which users join the meeting

A list of the call's participants. A party must be provided for the primaryUser.

A list of links to external systems such as CRM, Telephony System, Case Management, etc.

The email address of the party, if available.

The audio channel corresponding to the company team member (rep) used when the uploaded media file is multi-channel (stereo). The channel id is either 0 or 1 (representing left or right respectively)

An identifier that is only required when speakersTimeline is provided.
 The partyId is used to recognize the speakers within the provided speakersTimeline.

The phone number of the party, if available.

The user ID of the participant within the Gong system, if the participant is a user.

The Gong internal user ID of the team member who hosted the call.

The primary user ID of the team member who hosted the call.

The purpose of the call. This optional field is a free text of up to 255 characters.

Scheduled date and time of the call in the ISO-8601 format (e.g., '2018-02-18T02:30:00-07:00' or '2018-02-18T08:00:00Z', where Z stands for UTC).

The date and time the call was scheduled to end in the ISO-8601 format (e.g., '2018-02-18T02:30:00-07:00' or '2018-02-18T08:00:00Z', where Z stands for UTC);

The date and time the call was scheduled to begin in the ISO-8601 format (e.g., '2018-02-18T02:30:00-07:00' or '2018-02-18T08:00:00Z', where Z stands for UTC);

The scope of the call: 'internal' if all the participants are from the company, 'external' if some participants are not from the company, or 'unknown' if the scope is unknown.

The audio recording speech segments (who spoke when). Note that speakersTimeline and mediaChannelId are mutually exclusive, when providing speakersTimeline - mediaChannelId will not be used.

Indicates whether the provided speech segments match the media precisely or need further refinement based on the media. "Precisely" here means that segments do not deviate from the actual speech in the media by more than 100ms.

The audio recording speech segments (who spoke when). 

The date and time when the call was recorded in the ISO-8601 format (e.g., '2018-02-18T02:30:00-07:00' or '2018-02-18T08:00:00Z', where Z stands for UTC).

The system with which the call was carried out (e.g., WebEx, ShoreTel, etc.).

The title of the call. This title is available in the Gong system for indexing and search.

The URL to the page in the Gong web application where the call is available.

Optional workspace identifier. If specified, the call will be placed into this workspace, otherwise, the default algorithm for workspace placement will be applied.

Data

Calls

Basic details such as sub-folders, title, etc.

Gong's unique numeric identifier for the user who added the folder.

Gong's unique numeric identifier for a library's folder (up to 20 digits).

Gong's unique numeric identifier for library's parent folder (null for root folder).

Folder's last update time in the ISO-8601 format (e.g., '2020-03-14T05:30:00-08:00').

Library Folders

A list of sentences spoken in the monologue.

Unique ID of the speaker. Cross-reference this with the 'speakerId' field of objects in the 'parties' array returned from endpoint '/v2/calls/extensive' to identify the participant.

Transcripts

True if the user is active, false if not.

Creation time in the ISO-8601 format (e.g., '2018-02-18T02:30:00-07:00' or '2018-02-18T08:00:00Z', where Z stands for UTC);of the Gong user.

List of email address aliases of the Gong user.

Gong's unique numeric identifier for the user (up to 20 digits).

The list of personal meeting URLs of the Gong user.

Languages spoken during calls by the Gong user

Language spoken by the user encoded according to the BCP-47 standard.

Indicates the primary language (one per user). The language will be assumed when the system cannot identify the language of a call, e.g., due to poor quality or the call being too short.

The trusted authentication email assigned to the Gong user

Users

A list, in which each item provides a workspace metadata.

Gong's unique numeric identifier for the workspace (up to 20 digits).

Workspaces

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) file separated by speaker, make sure to specify which channel correspondsto the company team member (rep) in the parties/mediaChannelId parameter of the Add New Call operation.

When accessed through a Bearer token authorization method, this endpoint requires the scope 'api:calls:create'.

Add call media (/v2/calls/{id}/media)

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 requires the scope 'api:calls:create'.

Add new call (/v2/calls)

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

Post a Digital Interaction (/v2/digital-interaction)

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

Create a New Gong Meeting (/v2/meetings)

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 authorization method, this endpoint requires the scope 'api:call-user-access:write'.

Give individual users access to calls (/v2/calls/users-access)

Assign a Gong Engage flow to a batch of prospects.

Gong Engage requires 'prospectsCrmIds' to fetch the prospects from the CRM, the chosen 'gongFlowId' to assign to the prospect, and an 'assignToEmail' which is the email address of the Gong user for whom the flow tasks will be created.

The maximum allowed prospects to be assigned in a single request is 200

When accessed through a Bearer token authorization method, this endpoint requires the scope 'api:flows:write'.

Assign a Gong Engage flow to prospects  (/v2/flows/prospects/assign)

Push engagement events into Gong and display them as events in Gong’s activity timeline, when a Gong user shares content with external participants (for example, a contract was “shared” by the account executive with his prospects)

When accessed through a Bearer token authorization method, this endpoint requires the scope 'api:engagement-data:write'.

Report event of a content share (/v2/customer-engagement/content/shared)

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 authorization method, this endpoint requires the scope 'api:engagement-data:write'.

Report event of a content view (/v2/customer-engagement/content/viewed)

Create a permission profile in a given workspace.

Create permission profile (/v2/permission-profile)

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 authorization method, this endpoint requires the scope 'api:engagement-data:write'.

Report event of a custom action (/v2/customer-engagement/action)

Delete Generic Crm Integration Deprecated

Delete a Generic CRM integration (/v2/crm/integrations)

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

Delete a Gong Meeting (/v2/meetings)

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 the call, but not through the pubic API (for example if the call was shared with the user), the user's access will remain unchanged.

When accessed through a Bearer token authorization method, this endpoint requires the scope 'api:call-user-access:write'.

Remove specific individual users access from calls (/v2/calls/users-access)

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 address.

When accessed through a Bearer token authorization method, this endpoint requires the scope 'api:data-privacy:read'.

Retrieve all references to an email address. (/v2/data-privacy/data-for-email-address)

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 through a Bearer token authorization method, this endpoint requires the scope 'api:data-privacy:read'.

Retrieve all references to a phone number. (/v2/data-privacy/data-for-phone-number)

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 authorization method, this endpoint requires the scope 'api:calls:read:transcript'.

Retrieve transcripts of calls (/v2/calls/transcript)

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 for a specific call (/v2/calls/{id})

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 of calls in a specific folder (/v2/library/folder-content)

Get Crm Objects Deprecated

Get CRM objects (/v2/crm/entities)

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 assigned flows for the given prospects (/v2/flows/prospects)

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 Library folders (/v2/library/folders)

Permission profile for a given profile Id (/v2/permission-profile)

Get Request Status (/v2/crm/request-status)

Retrieve a specific user's settings history.

When accessed through a Bearer token authorization method, this endpoint requires the scope 'api:users:read'.

Retrieve user settings history (/v2/users/{id}/settings-history)

Retrieve a specific user.

When accessed through a Bearer token authorization method, this endpoint requires the scope 'api:users:read'.

Retrieve user (/v2/users/{id})

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 through a Bearer token authorization method, this endpoint requires the scope 'api:call-user-access:read'.

Retrieve users that have specific individual access to calls (/v2/calls/users-access)

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

Validate Gong meeting Integration (/v2/meetings/integration/status)

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 token authorization method, this endpoint requires the scope 'api:stats:scorecards'.

Retrieve answered scorecards for applicable reviewed users or scorecards for a date range (/v2/stats/activity/scorecards)

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:read:extensive'. 
Moreover, clients requesting media download URLs by the contentSelector.exposedFields.media field should also have the scope 'api:calls:read:media-url'.

Retrieve detailed call data by various filters (/v2/calls/extensive)

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 call data by date range (/v2/calls)

List Crm Schema Fields Deprecated

List Schema Fields (/v2/crm/entity-schema)

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-associated the API will return both events.

When accessed through a Bearer token authorization method, this endpoint requires the scope 'api:crm-calls:manual-association:read'.

List all calls that were manually associated with CRM objects (/v2/calls/manual-crm-associations) in Beta Phase

Lists all 'COMPANY' flows and optionally 'Personal' flows available for the user to choose from. 

Gong Engage sorts flows by 2 visibility types: 'Personal' and 'Company' 

When accessed through a Bearer token authorization method, this endpoint requires the scope 'api:flows:read'.

List Gong Engage flows (/v2/flows)

List Generic Crm Integration Deprecated

Get Generic CRM integration details (/v2/crm/integrations)

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'.

Retrieve interaction stats for applicable users by date (/v2/stats/interaction)

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 logs data by type and time range (/v2/logs)

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 about the user's activity.

When accessed through a Bearer token authorization method, this endpoint requires the scope 'api:stats:user-actions'.

Retrieve aggregated activity for defined users by date (/v2/stats/activity/aggregate)

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 date range, including statistics about the user's activity. Records are returned only for users with activity in the range.

When accessed through a Bearer token authorization method, this endpoint requires the scope 'api:stats:user-actions'.

Retrieve aggregated activity for defined users by a date range with grouping in time periods (/v2/stats/activity/aggregate-by-period)

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 in the range.

When accessed through a Bearer token authorization method, this endpoint requires the scope 'api:stats:user-actions:detailed'.

Retrieve daily activity for applicable users for a date range (/v2/stats/activity/day-by-day)

List multiple Users.

When accessed through a Bearer token authorization method, this endpoint requires the scope 'api:users:read'.

List users by filter (/v2/users/extensive)

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'.

List all users attached to a given permission profile (/v2/permission-profile/users)

Returns a list of all permission profiles.

The listing is in the alphabetical order of the profile names.

List all company permission profiles for a given workspace (/v2/all-permission-profiles)

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 scorecards details (/v2/settings/scorecards)

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 tracker details (/v2/settings/trackers)

List all of the company's users.

When accessed through a Bearer token authorization method, this endpoint requires the scope 'api:users:read'.

List all users (/v2/users)

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 company workspaces (/v2/workspaces)

Map Crm Users

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, attendee or speaker) are deleted. Leads or Contacts with the email address are deleted. The deletion is not immediate, and may take several hours to complete.

This endpoint contains a data integrity protection mechanism to prevent the deletion of an abnormal number of objects. If the deletion fails please contact support at help@gong.io

Delete the data from your CRM and email system before performing this operation so that private data is not re-imported into Gong.

When accessed through a Bearer token authorization method, this endpoint requires the scope 'api:data-privacy:delete'.

Delete the email address, and all associated elements (/v2/data-privacy/erase-data-for-email-address)

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 appear are deleted. The deletion is not immediate, and may take several hours to complete.

This endpoint contains a data integrity protection mechanism to prevent the deletion of an abnormal number of objects. If the deletion fails please contact support at help@gong.io

Delete the data from your CRM and email system before performing this operation so that private data is not re-imported into Gong.

When accessed through a Bearer token authorization method, this endpoint requires the scope 'api:data-privacy:delete'.

Delete the phone number, and all associated elements (/v2/data-privacy/erase-data-for-phone-number)

Register Generic Crm Integration Deprecated

Register a Generic CRM integration (/v2/crm/integrations)

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

Update a Gong Meeting (/v2/meetings/{meetingId})

Update permission profile (/v2/permission-profile)

Upload Crm Data Deprecated

Upload CRM objects (/v2/crm/entities)

Upload Crm Schema Field Deprecated

	List	Find by ID	Create	Update	Delete
Calls	✅	✅	✅	➖	➖
Users	✅	✅	➖	➖	➖
Library Folders	✅	➖	➖	➖	➖
Transcripts	✅	➖	➖	➖	➖
Workspaces	✅	➖	➖	➖	➖

Gong integration connector

Managed authentication

Execute Gong operations on behalf of your customers

Add call media (/v2/calls/{id}/media)

Add new call (/v2/calls)

Post a Digital Interaction (/v2/digital-interaction)

Create a New Gong Meeting (/v2/meetings)

Give individual users access to calls (/v2/calls/users-access)

Assign a Gong Engage flow to prospects (/v2/flows/prospects/assign)

Work with Gong data collections

Trigger integrations on Gong events

Data Record Created

Data Record Updated

Data Record Deleted

Try our AI-powered integration development environment for free

Gong integration connector

Managed authentication

Execute Gong operations on behalf of your customersself.__wrap_n!=1&&self.__wrap_b(":Rat56:",1)

Add call media (/v2/calls/{id}/media)

Add new call (/v2/calls)

Post a Digital Interaction (/v2/digital-interaction)

Create a New Gong Meeting (/v2/meetings)

Give individual users access to calls (/v2/calls/users-access)

Assign a Gong Engage flow to prospects (/v2/flows/prospects/assign)

Work with Gong data collectionsself.__wrap_n!=1&&self.__wrap_b(":Rb556:",1)

Trigger integrations on Gong eventsself.__wrap_n!=1&&self.__wrap_b(":Rbd56:",1)

Data Record Created

Data Record Updated

Data Record Deleted

Try our AI-powered integration development environment for free

Execute Gong operations on behalf of your customers

Work with Gong data collections

Trigger integrations on Gong events