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

python

await gong.users.list()

API

bash

curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_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

<details> <summary>Response Schema</summary>

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`

</details>

Users Get

Get a single user by ID

Python SDK

python

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

API

bash

curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_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

<details> <summary>Response Schema</summary>

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>`

</details>

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

python

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

API

bash

curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_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 `meta.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

<details> <summary>Response Schema</summary>

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

</details>

Calls

Calls List

Retrieve calls data by date range

Python SDK

python

await gong.calls.list()

API

bash

curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_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

<details> <summary>Response Schema</summary>

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`

</details>

Calls Get

Get specific call data by ID

Python SDK

python

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

API

bash

curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_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

<details> <summary>Response Schema</summary>

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`

</details>

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

python

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

API

bash

curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_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 `meta.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.

<details> <summary>Response Schema</summary>

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

</details>

Calls Extensive

Calls Extensive List

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

Python SDK

python

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

API

bash

curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_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

<details> <summary>Response Schema</summary>

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`

</details>

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

python

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

API

bash

curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_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 `meta.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

<details> <summary>Response Schema</summary>

Field Name	Type	Description
`data`	`array`	List of matching records
`meta`	`object`	Pagination metadata
`meta.has_more`	`boolean`	Whether additional pages are available
`meta.cursor`	`string \| null`	Cursor for next page of results
`meta.took_ms`	`number \| null`	Query execution time in milliseconds
`data[].id`	`integer`	Unique identifier for the call (from metaData.id).
`data[].startdatetime`	`string`	Datetime for extensive calls.
`data[].collaboration`	`object`	Collaboration information added to the call
`data[].content`	`object`	Analysis of the interaction content.
`data[].context`	`object`	A list of the agenda of each part of the call.
`data[].interaction`	`object`	Metrics collected around the interaction during the call.
`data[].media`	`object`	The media urls of the call.
`data[].metaData`	`object`	call's metadata.
`data[].parties`	`array`	A list of the call's participants

</details>

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

python

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

bash

curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_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

python

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

bash

curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_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

python

await gong.workspaces.list()

API

bash

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

<details> <summary>Response Schema</summary>

Records

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

</details>

Call Transcripts

Call Transcripts List

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

Python SDK

python

await gong.call_transcripts.list()

API

bash

curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_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

<details> <summary>Response Schema</summary>

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`

</details>

Stats Activity Aggregate

Stats Activity Aggregate List

Provides aggregated user activity metrics across a specified period

Python SDK

python

await gong.stats_activity_aggregate.list()

API

bash

curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_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

<details> <summary>Response Schema</summary>

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`

</details>

Stats Activity Day By Day

Stats Activity Day By Day List

Delivers daily user activity metrics across a specified date range

Python SDK

python

await gong.stats_activity_day_by_day.list()

API

bash

curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_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

<details> <summary>Response Schema</summary>

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`

</details>

Stats Interaction

Stats Interaction List

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

Python SDK

python

await gong.stats_interaction.list()

API

bash

curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_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

<details> <summary>Response Schema</summary>

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`

</details>

Settings Scorecards

Settings Scorecards List

Retrieve all scorecard configurations in the company

Python SDK

python

await gong.settings_scorecards.list()

API

bash

curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_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

<details> <summary>Response Schema</summary>

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>`

</details>

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

python

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

API

bash

curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_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 `meta.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

<details> <summary>Response Schema</summary>

Field Name	Type	Description
`data`	`array`	List of matching records
`meta`	`object`	Pagination metadata
`meta.has_more`	`boolean`	Whether additional pages are available
`meta.cursor`	`string \| null`	Cursor for next page of results
`meta.took_ms`	`number \| null`	Query execution time in milliseconds
`data[].created`	`string`	The timestamp when the scorecard was created
`data[].enabled`	`boolean`	Indicates if the scorecard is enabled or disabled
`data[].questions`	`array`	An array of questions related to the scorecard
`data[].scorecardId`	`string`	The unique identifier of the scorecard
`data[].scorecardName`	`string`	The name of the scorecard
`data[].updated`	`string`	The timestamp when the scorecard was last updated
`data[].updaterUserId`	`string`	The user ID of the person who last updated the scorecard
`data[].workspaceId`	`string`	The unique identifier of the workspace associated with the scorecard

</details>

Settings Trackers

Settings Trackers List

Retrieve all keyword tracker configurations in the company

Python SDK

python

await gong.settings_trackers.list()

API

bash

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

Parameters

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

<details> <summary>Response Schema</summary>

Records

Field Name	Type	Description
`trackerId`	`string`
`trackerName`	`string`
`workspaceId`	`string \| null`
`languageKeywords`	`array<object>`
`affiliation`	`string`
`partOfQuestion`	`boolean`
`saidAt`	`string`
`saidAtInterval`	`string \| null`
`saidAtUnit`	`string \| null`
`saidInTopics`	`array<string>`
`filterQuery`	`string`
`created`	`string`
`creatorUserId`	`string \| null`
`updated`	`string`
`updaterUserId`	`string \| null`

</details>

Library Folders

Library Folders List

Retrieve the folder structure of the call library

Python SDK

python

await gong.library_folders.list(
    workspace_id="<str>"
)

API

bash

curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "library_folders",
    "action": "list",
    "params": {
        "workspaceId": "<str>"
    }
}'

Parameters

Parameter Name	Type	Required	Description
`workspaceId`	`string`	Yes	Workspace ID to retrieve folders from

<details> <summary>Response Schema</summary>

Records

Field Name	Type	Description
`id`	`string`
`name`	`string`
`parentFolderId`	`string \| null`
`createdBy`	`string \| null`
`updated`	`string`

</details>

Library Folder Content

Library Folder Content List

Retrieve calls in a specific library folder

Python SDK

python

await gong.library_folder_content.list(
    folder_id="<str>"
)

API

bash

curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "library_folder_content",
    "action": "list",
    "params": {
        "folderId": "<str>"
    }
}'

Parameters

Parameter Name	Type	Required	Description
`folderId`	`string`	Yes	Folder ID to retrieve content from
`cursor`	`string`	No	Cursor for pagination

<details> <summary>Response Schema</summary>

Records

Field Name	Type	Description
`callId`	`string`
`title`	`string`
`started`	`string`
`duration`	`integer`
`primaryUserId`	`string`
`url`	`string`

Meta

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

</details>

Coaching

Coaching List

Retrieve coaching metrics for a manager and their direct reports

Python SDK

python

await gong.coaching.list(
    workspace_id="<str>",
    manager_id="<str>",
    from_="2025-01-01T00:00:00Z",
    to="2025-01-01T00:00:00Z"
)

API

bash

curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "coaching",
    "action": "list",
    "params": {
        "workspace-id": "<str>",
        "manager-id": "<str>",
        "from": "2025-01-01T00:00:00Z",
        "to": "2025-01-01T00:00:00Z"
    }
}'

Parameters

Parameter Name	Type	Required	Description
`workspace-id`	`string`	Yes	Workspace ID
`manager-id`	`string`	Yes	Manager user ID
`from`	`string`	Yes	Start date in ISO 8601 format
`to`	`string`	Yes	End date in ISO 8601 format

<details> <summary>Response Schema</summary>

Records

Field Name	Type	Description
`userId`	`string`
`userEmailAddress`	`string`
`userName`	`string`
`isManager`	`boolean`
`coachingMetrics`	`object`
`coachingMetrics.callsListened`	`integer`
`coachingMetrics.callsAttended`	`integer`
`coachingMetrics.callsWithFeedback`	`integer`
`coachingMetrics.callsWithComments`	`integer`
`coachingMetrics.scorecardsFilled`	`integer`

</details>

Stats Activity Scorecards

Stats Activity Scorecards List

Retrieve answered scorecards for applicable reviewed users or scorecards for a date range

Python SDK

python

await gong.stats_activity_scorecards.list()

API

bash

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

Parameters

Parameter Name	Type	Required	Description
`filter`	`object`	No
`filter.fromDateTime`	`string`	No	Start date in ISO 8601 format
`filter.toDateTime`	`string`	No	End date in ISO 8601 format
`filter.scorecardIds`	`array<string>`	No	List of scorecard IDs to filter by
`filter.reviewedUserIds`	`array<string>`	No	List of reviewed user IDs to filter by
`filter.reviewerUserIds`	`array<string>`	No	List of reviewer user IDs to filter by
`filter.callIds`	`array<string>`	No	List of call IDs to filter by
`cursor`	`string`	No	Cursor for pagination

<details> <summary>Response Schema</summary>

Records

Field Name	Type	Description
`answeredScorecardId`	`string`
`scorecardId`	`string`
`scorecardName`	`string`
`callId`	`string`
`callStartTime`	`string`
`reviewedUserId`	`string`
`reviewerUserId`	`string`
`reviewMethod`	`string`
`editorUserId`	`string \| null`
`answeredDateTime`	`string`
`reviewTime`	`string`
`visibilityType`	`string`
`answers`	`array<object>`
`answers[].questionId`	`string`
`answers[].questionRevisionId`	`string`
`answers[].isOverall`	`boolean`
`answers[].answer`	`string`
`answers[].answerText`	`string \| null`
`answers[].score`	`number`
`answers[].notApplicable`	`boolean`
`answers[].selectedOptions`	`array \| null`
`overallScore`	`number`
`visibility`	`string`

Meta

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

</details>

Stats Activity Scorecards Search

Search and filter stats activity 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

python

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

API

bash

curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "stats_activity_scorecards",
    "action": "search",
    "params": {
        "query": {"filter": {"eq": {"answeredScorecardId": "<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 `meta.cursor`
`fields`	`array`	No	Field paths to include in results

Searchable Fields

Field Name	Type	Description
`answeredScorecardId`	`string`	Unique identifier for the answered scorecard instance.
`answers`	`array`	Contains the answered questions in the scorecards
`callId`	`string`	Unique identifier for the call associated with the answered scorecard.
`callStartTime`	`string`	Timestamp indicating the start time of the call.
`reviewTime`	`string`	Timestamp indicating when the review of the answered scorecard was completed.
`reviewedUserId`	`string`	Unique identifier for the user whose performance was reviewed.
`reviewerUserId`	`string`	Unique identifier for the user who performed the review.
`scorecardId`	`string`	Unique identifier for the scorecard template used.
`scorecardName`	`string`	Name or title of the scorecard template used.
`visibilityType`	`string`	Type indicating the visibility permissions for the answered scorecard.

<details> <summary>Response Schema</summary>

Field Name	Type	Description
`data`	`array`	List of matching records
`meta`	`object`	Pagination metadata
`meta.has_more`	`boolean`	Whether additional pages are available
`meta.cursor`	`string \| null`	Cursor for next page of results
`meta.took_ms`	`number \| null`	Query execution time in milliseconds
`data[].answeredScorecardId`	`string`	Unique identifier for the answered scorecard instance.
`data[].answers`	`array`	Contains the answered questions in the scorecards
`data[].callId`	`string`	Unique identifier for the call associated with the answered scorecard.
`data[].callStartTime`	`string`	Timestamp indicating the start time of the call.
`data[].reviewTime`	`string`	Timestamp indicating when the review of the answered scorecard was completed.
`data[].reviewedUserId`	`string`	Unique identifier for the user whose performance was reviewed.
`data[].reviewerUserId`	`string`	Unique identifier for the user who performed the review.
`data[].scorecardId`	`string`	Unique identifier for the scorecard template used.
`data[].scorecardName`	`string`	Name or title of the scorecard template used.
`data[].visibilityType`	`string`	Type indicating the visibility permissions for the answered scorecard.

</details>