How do I install the Gong full reference skill?

Run npx skillmds@latest add tools-only/gong-full-reference-3 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Gong full reference skill do?

This is the full reference documentation for the Gong agent connector. It is listed under Coding & Dev Tools on SkillMD.

Is Gong full reference safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Gong full reference?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Gong full reference free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Gong full reference?

tools-only (@tools-only) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Gong full reference by tools-only — Agent Skill

Name: Gong full reference
Author: tools-only

Gong full reference

This is the full reference documentation for the Gong agent connector.

Supported entities and actions

The Gong connector supports the following entities and actions.

Entity	Actions
Users	List, Get, Search
Calls	List, Get, Search
Calls Extensive	List, Search
Call Audio	Download
Call Video	Download
Workspaces	List
Call Transcripts	List
Stats Activity Aggregate	List
Stats Activity Day By Day	List
Stats Interaction	List
Settings Scorecards	List, Search
Settings Trackers	List
Library Folders	List
Library Folder Content	List
Coaching	List
Stats Activity Scorecards	List, Search

Users

Users List

Returns a list of all users in the Gong account

Python SDK

await gong.users.list()

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "users",
    "action": "list"
}'

Parameters

Parameter Name	Type	Required	Description
`cursor`	`string`	No	Cursor for pagination

Records

Field Name	Type	Description
`id`	`string`
`emailAddress`	`string`
`created`	`string`
`active`	`boolean`
`emailAliases`	`array<string>`
`trustedEmailAddress`	`string \| null`
`firstName`	`string`
`lastName`	`string`
`title`	`string \| null`
`phoneNumber`	`string \| null`
`extension`	`string \| null`
`personalMeetingUrls`	`array<string>`
`settings`	`object`
`managerId`	`string \| null`
`meetingConsentPageUrl`	`string \| null`
`spokenLanguages`	`array<object>`

Meta

Field Name	Type	Description
`pagination`	`object`
`pagination.totalRecords`	`integer`
`pagination.currentPageSize`	`integer`
`pagination.currentPageNumber`	`integer`
`pagination.cursor`	`string`

Users Get

Get a single user by ID

Python SDK

await gong.users.get(
    id="<str>"
)

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "users",
    "action": "get",
    "params": {
        "id": "<str>"
    }
}'

Parameters

Parameter Name	Type	Required	Description
`id`	`string`	Yes	User ID

Records

Field Name	Type	Description
`id`	`string`
`emailAddress`	`string`
`created`	`string`
`active`	`boolean`
`emailAliases`	`array<string>`
`trustedEmailAddress`	`string \| null`
`firstName`	`string`
`lastName`	`string`
`title`	`string \| null`
`phoneNumber`	`string \| null`
`extension`	`string \| null`
`personalMeetingUrls`	`array<string>`
`settings`	`object`
`managerId`	`string \| null`
`meetingConsentPageUrl`	`string \| null`
`spokenLanguages`	`array<object>`

Users Search

Search and filter users records powered by Airbyte's data sync. This often provides additional fields and operators beyond what the API natively supports, making it easier to narrow down results before performing further operations. Only available in hosted mode.

Python SDK

await gong.users.search(
    query={"filter": {"eq": {"active": True}}}
)

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "users",
    "action": "search",
    "params": {
        "query": {"filter": {"eq": {"active": True}}}
    }
}'

Parameters

Parameter Name	Type	Required	Description
`query`	`object`	Yes	Filter and sort conditions. Supports operators: eq, neq, gt, gte, lt, lte, in, like, fuzzy, keyword, not, and, or
`query.filter`	`object`	No	Filter conditions
`query.sort`	`array`	No	Sort conditions
`limit`	`integer`	No	Maximum results to return (default 1000)
`cursor`	`string`	No	Pagination cursor from previous response's next_cursor
`fields`	`array`	No	Field paths to include in results

Searchable Fields

Field Name	Type	Description
`active`	`boolean`	Indicates if the user is currently active or not
`created`	`string`	The timestamp denoting when the user account was created
`emailAddress`	`string`	The primary email address associated with the user
`emailAliases`	`array`	Additional email addresses that can be used to reach the user
`extension`	`string`	The phone extension number for the user
`firstName`	`string`	The first name of the user
`id`	`string`	Unique identifier for the user
`lastName`	`string`	The last name of the user
`managerId`	`string`	The ID of the user's manager
`meetingConsentPageUrl`	`string`	URL for the consent page related to meetings
`personalMeetingUrls`	`array`	URLs for personal meeting rooms assigned to the user
`phoneNumber`	`string`	The phone number associated with the user
`settings`	`object`	User-specific settings and configurations
`spokenLanguages`	`array`	Languages spoken by the user
`title`	`string`	The job title or position of the user
`trustedEmailAddress`	`string`	An email address that is considered trusted for the user

Field Name	Type	Description
`hits`	`array`	List of matching records
`hits[].id`	`string`	Record identifier
`hits[].score`	`number`	Relevance score
`hits[].data`	`object`	Record data containing the searchable fields listed above
`hits[].data.active`	`boolean`	Indicates if the user is currently active or not
`hits[].data.created`	`string`	The timestamp denoting when the user account was created
`hits[].data.emailAddress`	`string`	The primary email address associated with the user
`hits[].data.emailAliases`	`array`	Additional email addresses that can be used to reach the user
`hits[].data.extension`	`string`	The phone extension number for the user
`hits[].data.firstName`	`string`	The first name of the user
`hits[].data.id`	`string`	Unique identifier for the user
`hits[].data.lastName`	`string`	The last name of the user
`hits[].data.managerId`	`string`	The ID of the user's manager
`hits[].data.meetingConsentPageUrl`	`string`	URL for the consent page related to meetings
`hits[].data.personalMeetingUrls`	`array`	URLs for personal meeting rooms assigned to the user
`hits[].data.phoneNumber`	`string`	The phone number associated with the user
`hits[].data.settings`	`object`	User-specific settings and configurations
`hits[].data.spokenLanguages`	`array`	Languages spoken by the user
`hits[].data.title`	`string`	The job title or position of the user
`hits[].data.trustedEmailAddress`	`string`	An email address that is considered trusted for the user
`next_cursor`	`string \| null`	Cursor for next page of results
`took_ms`	`number`	Query execution time in milliseconds

Calls

Calls List

Retrieve calls data by date range

Python SDK

await gong.calls.list()

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "calls",
    "action": "list"
}'

Parameters

Parameter Name	Type	Required	Description
`fromDateTime`	`string`	No	Start date in ISO 8601 format
`toDateTime`	`string`	No	End date in ISO 8601 format
`cursor`	`string`	No	Cursor for pagination

Records

Field Name	Type	Description
`id`	`string`
`url`	`string`
`title`	`string`
`scheduled`	`string`
`started`	`string`
`duration`	`integer`
`primaryUserId`	`string`
`direction`	`string`
`system`	`string`
`scope`	`string`
`media`	`string`
`language`	`string`
`workspaceId`	`string`
`sdrDisposition`	`string \| null`
`clientUniqueId`	`string \| null`
`customData`	`string \| null`
`purpose`	`string \| null`
`meetingUrl`	`string`
`isPrivate`	`boolean`
`calendarEventId`	`string \| null`

Meta

Field Name	Type	Description
`pagination`	`object`
`pagination.totalRecords`	`integer`
`pagination.currentPageSize`	`integer`
`pagination.currentPageNumber`	`integer`
`pagination.cursor`	`string`

Calls Get

Get specific call data by ID

Python SDK

await gong.calls.get(
    id="<str>"
)

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "calls",
    "action": "get",
    "params": {
        "id": "<str>"
    }
}'

Parameters

Parameter Name	Type	Required	Description
`id`	`string`	Yes	Call ID

Records

Field Name	Type	Description
`id`	`string`
`url`	`string`
`title`	`string`
`scheduled`	`string`
`started`	`string`
`duration`	`integer`
`primaryUserId`	`string`
`direction`	`string`
`system`	`string`
`scope`	`string`
`media`	`string`
`language`	`string`
`workspaceId`	`string`
`sdrDisposition`	`string \| null`
`clientUniqueId`	`string \| null`
`customData`	`string \| null`
`purpose`	`string \| null`
`meetingUrl`	`string`
`isPrivate`	`boolean`
`calendarEventId`	`string \| null`

Calls Search

Search and filter calls records powered by Airbyte's data sync. This often provides additional fields and operators beyond what the API natively supports, making it easier to narrow down results before performing further operations. Only available in hosted mode.

Python SDK

await gong.calls.search(
    query={"filter": {"eq": {"calendarEventId": "<str>"}}}
)

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "calls",
    "action": "search",
    "params": {
        "query": {"filter": {"eq": {"calendarEventId": "<str>"}}}
    }
}'

Parameters

Parameter Name	Type	Required	Description
`query`	`object`	Yes	Filter and sort conditions. Supports operators: eq, neq, gt, gte, lt, lte, in, like, fuzzy, keyword, not, and, or
`query.filter`	`object`	No	Filter conditions
`query.sort`	`array`	No	Sort conditions
`limit`	`integer`	No	Maximum results to return (default 1000)
`cursor`	`string`	No	Pagination cursor from previous response's next_cursor
`fields`	`array`	No	Field paths to include in results

Searchable Fields

Field Name	Type	Description
`calendarEventId`	`string`	Unique identifier for the calendar event associated with the call.
`clientUniqueId`	`string`	Unique identifier for the client related to the call.
`customData`	`string`	Custom data associated with the call.
`direction`	`string`	Direction of the call (inbound/outbound).
`duration`	`integer`	Duration of the call in seconds.
`id`	`string`	Unique identifier for the call.
`isPrivate`	`boolean`	Indicates if the call is private or not.
`language`	`string`	Language used in the call.
`media`	`string`	Media type used for communication (voice, video, etc.).
`meetingUrl`	`string`	URL for accessing the meeting associated with the call.
`primaryUserId`	`string`	Unique identifier for the primary user involved in the call.
`purpose`	`string`	Purpose or topic of the call.
`scheduled`	`string`	Scheduled date and time of the call.
`scope`	`string`	Scope or extent of the call.
`sdrDisposition`	`string`	Disposition set by the sales development representative.
`started`	`string`	Start date and time of the call.
`system`	`string`	System information related to the call.
`title`	`string`	Title or headline of the call.
`url`	`string`	URL associated with the call.
`workspaceId`	`string`	Identifier for the workspace to which the call belongs.

Field Name	Type	Description
`hits`	`array`	List of matching records
`hits[].id`	`string`	Record identifier
`hits[].score`	`number`	Relevance score
`hits[].data`	`object`	Record data containing the searchable fields listed above
`hits[].data.calendarEventId`	`string`	Unique identifier for the calendar event associated with the call.
`hits[].data.clientUniqueId`	`string`	Unique identifier for the client related to the call.
`hits[].data.customData`	`string`	Custom data associated with the call.
`hits[].data.direction`	`string`	Direction of the call (inbound/outbound).
`hits[].data.duration`	`integer`	Duration of the call in seconds.
`hits[].data.id`	`string`	Unique identifier for the call.
`hits[].data.isPrivate`	`boolean`	Indicates if the call is private or not.
`hits[].data.language`	`string`	Language used in the call.
`hits[].data.media`	`string`	Media type used for communication (voice, video, etc.).
`hits[].data.meetingUrl`	`string`	URL for accessing the meeting associated with the call.
`hits[].data.primaryUserId`	`string`	Unique identifier for the primary user involved in the call.
`hits[].data.purpose`	`string`	Purpose or topic of the call.
`hits[].data.scheduled`	`string`	Scheduled date and time of the call.
`hits[].data.scope`	`string`	Scope or extent of the call.
`hits[].data.sdrDisposition`	`string`	Disposition set by the sales development representative.
`hits[].data.started`	`string`	Start date and time of the call.
`hits[].data.system`	`string`	System information related to the call.
`hits[].data.title`	`string`	Title or headline of the call.
`hits[].data.url`	`string`	URL associated with the call.
`hits[].data.workspaceId`	`string`	Identifier for the workspace to which the call belongs.
`next_cursor`	`string \| null`	Cursor for next page of results
`took_ms`	`number`	Query execution time in milliseconds

Calls Extensive

Calls Extensive List

Retrieve detailed call data including participants, interaction stats, and content

Python SDK

await gong.calls_extensive.list(
    filter={}
)

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "calls_extensive",
    "action": "list",
    "params": {
        "filter": {}
    }
}'

Parameters

Parameter Name	Type	Required	Description
`filter`	`object`	Yes
`filter.fromDateTime`	`string`	No	Start date in ISO 8601 format
`filter.toDateTime`	`string`	No	End date in ISO 8601 format
`filter.callIds`	`array<string>`	No	List of specific call IDs to retrieve
`filter.workspaceId`	`string`	No	Filter by workspace ID
`contentSelector`	`object`	No	Select which content to include in the response
`contentSelector.context`	`"Extended"`	No	Context level for the data
`contentSelector.contextTiming`	`array<"Now" \| "TimeOfCall">`	No	Context timing options
`contentSelector.exposedFields`	`object`	No	Specify which fields to include in the response
`contentSelector.exposedFields.collaboration`	`object`	No
`contentSelector.exposedFields.collaboration.publicComments`	`boolean`	No	Include public comments
`contentSelector.exposedFields.content`	`object`	No
`contentSelector.exposedFields.content.pointsOfInterest`	`boolean`	No	Include points of interest (deprecated, use highlights)
`contentSelector.exposedFields.content.structure`	`boolean`	No	Include call structure
`contentSelector.exposedFields.content.topics`	`boolean`	No	Include topics discussed
`contentSelector.exposedFields.content.trackers`	`boolean`	No	Include trackers
`contentSelector.exposedFields.content.trackerOccurrences`	`boolean`	No	Include tracker occurrences
`contentSelector.exposedFields.content.brief`	`boolean`	No	Include call brief
`contentSelector.exposedFields.content.outline`	`boolean`	No	Include call outline
`contentSelector.exposedFields.content.highlights`	`boolean`	No	Include call highlights
`contentSelector.exposedFields.content.callOutcome`	`boolean`	No	Include call outcome
`contentSelector.exposedFields.content.keyPoints`	`boolean`	No	Include key points
`contentSelector.exposedFields.interaction`	`object`	No
`contentSelector.exposedFields.interaction.personInteractionStats`	`boolean`	No	Include person interaction statistics
`contentSelector.exposedFields.interaction.questions`	`boolean`	No	Include questions asked
`contentSelector.exposedFields.interaction.speakers`	`boolean`	No	Include speaker information
`contentSelector.exposedFields.interaction.video`	`boolean`	No	Include video interaction data
`contentSelector.exposedFields.media`	`boolean`	No	Include media URLs (audio/video)
`contentSelector.exposedFields.parties`	`boolean`	No	Include participant information
`cursor`	`string`	No	Cursor for pagination

Records

Field Name	Type	Description
`metaData`	`object`
`parties`	`array<object>`
`interaction`	`object`
`collaboration`	`object`
`content`	`object`
`media`	`object`

Meta

Field Name	Type	Description
`pagination`	`object`
`pagination.totalRecords`	`integer`
`pagination.currentPageSize`	`integer`
`pagination.currentPageNumber`	`integer`
`pagination.cursor`	`string`

Calls Extensive Search

Search and filter calls extensive records powered by Airbyte's data sync. This often provides additional fields and operators beyond what the API natively supports, making it easier to narrow down results before performing further operations. Only available in hosted mode.

Python SDK

await gong.calls_extensive.search(
    query={"filter": {"eq": {"id": 0}}}
)

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "calls_extensive",
    "action": "search",
    "params": {
        "query": {"filter": {"eq": {"id": 0}}}
    }
}'

Parameters

Parameter Name	Type	Required	Description
`query`	`object`	Yes	Filter and sort conditions. Supports operators: eq, neq, gt, gte, lt, lte, in, like, fuzzy, keyword, not, and, or
`query.filter`	`object`	No	Filter conditions
`query.sort`	`array`	No	Sort conditions
`limit`	`integer`	No	Maximum results to return (default 1000)
`cursor`	`string`	No	Pagination cursor from previous response's next_cursor
`fields`	`array`	No	Field paths to include in results

Searchable Fields

Field Name	Type	Description
`id`	`integer`	Unique identifier for the call (from metaData.id).
`startdatetime`	`string`	Datetime for extensive calls.
`collaboration`	`object`	Collaboration information added to the call
`content`	`object`	Analysis of the interaction content.
`context`	`object`	A list of the agenda of each part of the call.
`interaction`	`object`	Metrics collected around the interaction during the call.
`media`	`object`	The media urls of the call.
`metaData`	`object`	call's metadata.
`parties`	`array`	A list of the call's participants

Field Name	Type	Description
`hits`	`array`	List of matching records
`hits[].id`	`string`	Record identifier
`hits[].score`	`number`	Relevance score
`hits[].data`	`object`	Record data containing the searchable fields listed above
`hits[].data.id`	`integer`	Unique identifier for the call (from metaData.id).
`hits[].data.startdatetime`	`string`	Datetime for extensive calls.
`hits[].data.collaboration`	`object`	Collaboration information added to the call
`hits[].data.content`	`object`	Analysis of the interaction content.
`hits[].data.context`	`object`	A list of the agenda of each part of the call.
`hits[].data.interaction`	`object`	Metrics collected around the interaction during the call.
`hits[].data.media`	`object`	The media urls of the call.
`hits[].data.metaData`	`object`	call's metadata.
`hits[].data.parties`	`array`	A list of the call's participants
`next_cursor`	`string \| null`	Cursor for next page of results
`took_ms`	`number`	Query execution time in milliseconds

Call Audio

Call Audio Download

ALWAYS configure the request with the exposedFields: {"media": true}. If you don't the call won't work. Downloads the audio media file for a call. Temporarily, the request body must be configured with: {"filter": {"callIds": [CALL_ID]}, "contentSelector": {"exposedFields": {"media": true}}}

Python SDK

async for chunk in gong.call_audio.download():# Process each chunk (e.g., write to file)
    file.write(chunk)

Note: Download operations return an async iterator of bytes chunks for memory-efficient streaming. Use async for to process chunks as they arrive.

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "call_audio",
    "action": "download"
}'

Parameters

Parameter Name	Type	Required	Description
`filter`	`object`	No
`filter.callIds`	`array<string>`	No	List containing the single call ID
`contentSelector`	`object`	No
`contentSelector.exposedFields`	`object`	No
`contentSelector.exposedFields.media`	`boolean`	No	Must be true to get media URLs
`range_header`	`string`	No	Optional Range header for partial downloads (e.g., 'bytes=0-99')

Call Video

Call Video Download

ALWAYS configure the request with the exposedFields: {"media": true}. If you don't the call won't work. Downloads the video media file for a call. Temporarily, the request body must be configured with: {"filter": {"callIds": [CALL_ID]}, "contentSelector": {"exposedFields": {"media": true}}}

Python SDK

async for chunk in gong.call_video.download():# Process each chunk (e.g., write to file)
    file.write(chunk)

Note: Download operations return an async iterator of bytes chunks for memory-efficient streaming. Use async for to process chunks as they arrive.

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "call_video",
    "action": "download"
}'

Parameters

Parameter Name	Type	Required	Description
`filter`	`object`	No
`filter.callIds`	`array<string>`	No	List containing the single call ID
`contentSelector`	`object`	No
`contentSelector.exposedFields`	`object`	No
`contentSelector.exposedFields.media`	`boolean`	No	Must be true to get media URLs
`range_header`	`string`	No	Optional Range header for partial downloads (e.g., 'bytes=0-99')

Workspaces

Workspaces List

List all company workspaces

Python SDK

await gong.workspaces.list()

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "workspaces",
    "action": "list"
}'

Records

Field Name	Type	Description
`id`	`string`
`workspaceId`	`string`
`name`	`string`
`description`	`string`

Call Transcripts

Call Transcripts List

Returns transcripts for calls in a specified date range or specific call IDs

Python SDK

await gong.call_transcripts.list()

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "call_transcripts",
    "action": "list"
}'

Parameters

Parameter Name	Type	Required	Description
`filter`	`object`	No
`filter.fromDateTime`	`string`	No	Start date in ISO 8601 format (optional if callIds provided)
`filter.toDateTime`	`string`	No	End date in ISO 8601 format (optional if callIds provided)
`filter.callIds`	`array<string>`	No	List of specific call IDs to retrieve transcripts for
`cursor`	`string`	No	Cursor for pagination

Records

Field Name	Type	Description
`callId`	`string`
`transcript`	`array<object>`

Meta

Field Name	Type	Description
`pagination`	`object`
`pagination.totalRecords`	`integer`
`pagination.currentPageSize`	`integer`
`pagination.currentPageNumber`	`integer`
`pagination.cursor`	`string`

Stats Activity Aggregate

Stats Activity Aggregate List

Provides aggregated user activity metrics across a specified period

Python SDK

await gong.stats_activity_aggregate.list()

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "stats_activity_aggregate",
    "action": "list"
}'

Parameters

Parameter Name	Type	Required	Description
`filter`	`object`	No
`filter.fromDate`	`string`	No	Start date (YYYY-MM-DD)
`filter.toDate`	`string`	No	End date (YYYY-MM-DD)
`filter.userIds`	`array<string>`	No	List of user IDs to retrieve stats for

Records

Field Name	Type	Description
`userId`	`string`
`userEmailAddress`	`string`
`userAggregateActivityStats`	`object`
`userAggregateActivityStats.callsAsHost`	`integer`
`userAggregateActivityStats.callsGaveFeedback`	`integer`
`userAggregateActivityStats.callsRequestedFeedback`	`integer`
`userAggregateActivityStats.callsReceivedFeedback`	`integer`
`userAggregateActivityStats.ownCallsListenedTo`	`integer`
`userAggregateActivityStats.othersCallsListenedTo`	`integer`
`userAggregateActivityStats.callsSharedInternally`	`integer`
`userAggregateActivityStats.callsSharedExternally`	`integer`
`userAggregateActivityStats.callsScorecardsFilled`	`integer`
`userAggregateActivityStats.callsScorecardsReceived`	`integer`
`userAggregateActivityStats.callsAttended`	`integer`
`userAggregateActivityStats.callsCommentsGiven`	`integer`
`userAggregateActivityStats.callsCommentsReceived`	`integer`
`userAggregateActivityStats.callsMarkedAsFeedbackGiven`	`integer`
`userAggregateActivityStats.callsMarkedAsFeedbackReceived`	`integer`

Meta

Field Name	Type	Description
`pagination`	`object`
`pagination.totalRecords`	`integer`
`pagination.currentPageSize`	`integer`
`pagination.currentPageNumber`	`integer`
`pagination.cursor`	`string`

Stats Activity Day By Day

Stats Activity Day By Day List

Delivers daily user activity metrics across a specified date range

Python SDK

await gong.stats_activity_day_by_day.list()

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "stats_activity_day_by_day",
    "action": "list"
}'

Parameters

Parameter Name	Type	Required	Description
`filter`	`object`	No
`filter.fromDate`	`string`	No	Start date (YYYY-MM-DD)
`filter.toDate`	`string`	No	End date (YYYY-MM-DD)
`filter.userIds`	`array<string>`	No	List of user IDs to retrieve stats for

Records

Field Name	Type	Description
`userId`	`string`
`userEmailAddress`	`string`
`userDailyActivityStats`	`array<object>`
`userDailyActivityStats[].callsAsHost`	`array<string>`
`userDailyActivityStats[].callsGaveFeedback`	`array<string>`
`userDailyActivityStats[].callsRequestedFeedback`	`array<string>`
`userDailyActivityStats[].callsReceivedFeedback`	`array<string>`
`userDailyActivityStats[].ownCallsListenedTo`	`array<string>`
`userDailyActivityStats[].othersCallsListenedTo`	`array<string>`
`userDailyActivityStats[].callsSharedInternally`	`array<string>`
`userDailyActivityStats[].callsSharedExternally`	`array<string>`
`userDailyActivityStats[].callsAttended`	`array<string>`
`userDailyActivityStats[].callsCommentsGiven`	`array<string>`
`userDailyActivityStats[].callsCommentsReceived`	`array<string>`
`userDailyActivityStats[].callsMarkedAsFeedbackGiven`	`array<string>`
`userDailyActivityStats[].callsMarkedAsFeedbackReceived`	`array<string>`
`userDailyActivityStats[].callsScorecardsFilled`	`array<string>`
`userDailyActivityStats[].callsScorecardsReceived`	`array<string>`
`userDailyActivityStats[].fromDate`	`string`
`userDailyActivityStats[].toDate`	`string`

Meta

Field Name	Type	Description
`pagination`	`object`
`pagination.totalRecords`	`integer`
`pagination.currentPageSize`	`integer`
`pagination.currentPageNumber`	`integer`
`pagination.cursor`	`string`

Stats Interaction

Stats Interaction List

Returns interaction stats for users based on calls that have Whisper turned on

Python SDK

await gong.stats_interaction.list()

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "stats_interaction",
    "action": "list"
}'

Parameters

Parameter Name	Type	Required	Description
`filter`	`object`	No
`filter.fromDate`	`string`	No	Start date (YYYY-MM-DD)
`filter.toDate`	`string`	No	End date (YYYY-MM-DD)
`filter.userIds`	`array<string>`	No	List of user IDs to retrieve stats for

Records

Field Name	Type	Description
`userId`	`string`
`userEmailAddress`	`string`
`personInteractionStats`	`array<object>`
`personInteractionStats[].name`	`string`
`personInteractionStats[].value`	`number`

Meta

Field Name	Type	Description
`pagination`	`object`
`pagination.totalRecords`	`integer`
`pagination.currentPageSize`	`integer`
`pagination.currentPageNumber`	`integer`
`pagination.cursor`	`string`

Settings Scorecards

Settings Scorecards List

Retrieve all scorecard configurations in the company

Python SDK

await gong.settings_scorecards.list()

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "settings_scorecards",
    "action": "list"
}'

Parameters

Parameter Name	Type	Required	Description
`workspaceId`	`string`	No	Filter scorecards by workspace ID

Records

Field Name	Type	Description
`scorecardId`	`string`
`scorecardName`	`string`
`workspaceId`	`string \| null`
`enabled`	`boolean`
`updaterUserId`	`string`
`created`	`string`
`updated`	`string`
`reviewMethod`	`string`
`questions`	`array<object>`
`questions[].questionId`	`string`
`questions[].questionRevisionId`	`string`
`questions[].questionText`	`string`
`questions[].questionType`	`string`
`questions[].isRequired`	`boolean`
`questions[].isOverall`	`boolean`
`questions[].updaterUserId`	`string`
`questions[].answerGuide`	`string \| null`
`questions[].minRange`	`string \| null`
`questions[].maxRange`	`string \| null`
`questions[].created`	`string`
`questions[].updated`	`string`
`questions[].answerOptions`	`array<object>`

Settings Scorecards Search

Search and filter settings scorecards records powered by Airbyte's data sync. This often provides additional fields and operators beyond what the API natively supports, making it easier to narrow down results before performing further operations. Only available in hosted mode.

Python SDK

await gong.settings_scorecards.search(
    query={"filter": {"eq": {"created": "<str>"}}}
)

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "settings_scorecards",
    "action": "search",
    "params": {
        "query": {"filter": {"eq": {"created": "<str>"}}}
    }
}'

Parameters

Parameter Name	Type	Required	Description
`query`	`object`	Yes	Filter and sort conditions. Supports operators: eq, neq, gt, gte, lt, lte, in, like, fuzzy, keyword, not, and, or
`query.filter`	`object`	No	Filter conditions
`query.sort`	`array`	No	Sort conditions
`limit`	`integer`	No	Maximum results to return (default 1000)
`cursor`	`string`	No	Pagination cursor from previous response's next_cursor
`fields`	`array`	No	Field paths to include in results

Searchable Fields

Field Name	Type	Description
`created`	`string`	The timestamp when the scorecard was created
`enabled`	`boolean`	Indicates if the scorecard is enabled or disabled
`questions`	`array`	An array of questions related to the scorecard
`scorecardId`	`string`	The unique identifier of the scorecard
`scorecardName`	`string`	The name of the scorecard
`updated`	`string`	The timestamp when the scorecard was last updated
`updaterUserId`	`string`	The user ID of the person who last updated the scorecard
`workspaceId`	`string`	The unique identifier of the workspace associated with the scorecard

Field Name	Type	Description
`hits`	`array`	List of matching records
`hits[].id`	`string`	Record identifier
`hits[].score`	`number`	Relevance score
`hits[].data`	`object`	Record data containing the searchable fields listed above
`hits[].data.created`	`string`	The timestamp when the score

…(truncated)

Gong full reference

File contents

Gong full reference

Supported entities and actions

Users

Users List

Python SDK

API

Parameters

Records

Meta

Users Get

Python SDK

API

Parameters

Records

Users Search

Python SDK

API

Parameters

Searchable Fields

Calls

Calls List

Python SDK

API

Parameters

Records

Meta

Calls Get

Python SDK

API

Parameters

Records

Calls Search

Python SDK

API

Parameters

Searchable Fields

Calls Extensive

Calls Extensive List

Python SDK

API

Parameters

Records

Meta

Calls Extensive Search

Python SDK

API

Parameters

Searchable Fields

Call Audio

Call Audio Download

Python SDK

API

Parameters

Call Video

Call Video Download

Python SDK

API

Parameters

Workspaces

Workspaces List

Python SDK

API

Records

Call Transcripts

Call Transcripts List

Python SDK

API

Parameters

Records

Meta

Stats Activity Aggregate

Stats Activity Aggregate List

Python SDK

API

Parameters

Records

Meta

Stats Activity Day By Day