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

Response Schema

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

Response Schema

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

Response Schema

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

Response Schema

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

Response Schema

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.

Response Schema

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

Response Schema

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

Response Schema

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

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

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"
}'

Response Schema

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

Response Schema

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

Response Schema

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

Response Schema

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

Response Schema

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

Response Schema

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

Response Schema

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 scorecard was created
hits[].data.enabled	boolean	Indicates if the scorecard is enabled or disabled
hits[].data.questions	array	An array of questions related to the scorecard
hits[].data.scorecardId	string	The unique identifier of the scorecard
hits[].data.scorecardName	string	The name of the scorecard
hits[].data.updated	string	The timestamp when the scorecard was last updated
hits[].data.updaterUserId	string	The user ID of the person who last updated the scorecard
hits[].data.workspaceId	string	The unique identifier of the workspace associated with the scorecard
next_cursor	string | null	Cursor for next page of results
took_ms	number	Query execution time in milliseconds

Settings Trackers

Settings Trackers List

Retrieve all keyword tracker configurations in the company

Python SDK

await gong.settings_trackers.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_trackers",
    "action": "list"
}'

Parameters

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

Response Schema

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

Library Folders

Library Folders List

Retrieve the folder structure of the call library

Python SDK

await gong.library_folders.list(
    workspace_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": "library_folders",
    "action": "list",
    "params": {
        "workspaceId": "<str>"
    }
}'

Parameters

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

Response Schema

Records

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

Library Folder Content

Library Folder Content List

Retrieve calls in a specific library folder

Python SDK

await gong.library_folder_content.list(
    folder_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": "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

Response Schema

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

Coaching

Coaching List

Retrieve coaching metrics for a manager and their direct reports

Python SDK

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

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": "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

Response Schema

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

Stats Activity Scorecards

Stats Activity Scorecards List

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

Python SDK

await gong.stats_activity_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": "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

Response Schema

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

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

await gong.stats_activity_scorecards.search(
    query={"filter": {"eq": {"answeredScorecardId": "<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": "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 next_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.

Response Schema

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.answeredScorecardId	string	Unique identifier for the answered scorecard instance.
hits[].data.answers	array	Contains the answered questions in the scorecards
hits[].data.callId	string	Unique identifier for the call associated with the answered scorecard.
hits[].data.callStartTime	string	Timestamp indicating the start time of the call.
hits[].data.reviewTime	string	Timestamp indicating when the review of the answered scorecard was completed.
hits[].data.reviewedUserId	string	Unique identifier for the user whose performance was reviewed.
hits[].data.reviewerUserId	string	Unique identifier for the user who performed the review.
hits[].data.scorecardId	string	Unique identifier for the scorecard template used.
hits[].data.scorecardName	string	Name or title of the scorecard template used.
hits[].data.visibilityType	string	Type indicating the visibility permissions for the answered scorecard.
next_cursor	string | null	Cursor for next page of results
took_ms	number	Query execution time in milliseconds