With Gong, manage calls and sales intelligence.
Manage calls and sales intelligence with Gong, including uploading new calls with metadata, retrieving call details, and searching calls based on criteria for comprehensive conversation analytics and sales performance tracking.
Required:
action
- The operation to perform (add-call, get-call, search-calls)Optional:
call-id
- Gong call IDclient-unique-id
- Unique client identifier for the callcall-title
- Title/name for the calldownload-media-url
- URL to download call media fileactual-start
- Call start timedirection
- Call direction (Inbound, Outbound)disposition
- Call disposition/outcomeparticipants
- Call participants informationprimary-user
- Primary user IDsearch-criteria
- Search criteria for call lookupUpload a new call to Gong with metadata and media file information
Parameters:
actual-start
(required) - Call start time in ISO formatclient-unique-id
(required) - Unique client identifierdownload-media-url
(required) - URL to download call media filecall-title
(required) - Title/name for the calldirection
(required) - Call direction (Inbound, Outbound)disposition
(optional) - Call disposition/outcomeparticipants
(required) - Array of participant informationprimary-user
(required) - Primary user IDExample:
Response:
Retrieve detailed information about a specific call using its unique ID
Parameters:
call-id
(required) - Gong call IDExample:
Response:
Search for calls based on specific criteria such as date range, participants, or keywords
Parameters:
from-date
(optional) - Search from dateto-date
(optional) - Search to dateprimary-user-ids
(optional) - Array of primary user IDskeywords
(optional) - Keywords to search forcontext
(optional) - Content context level (Extended, Basic)include-content
(optional) - Include call content analysisinclude-media
(optional) - Include media URLsExample:
Response:
Gong API requires media file URLs for call uploads. Client unique IDs prevent duplicate call uploads. Participants can be internal (with user IDs) or external (with phone numbers). Media channel IDs identify audio/video streams. Call dispositions categorize call outcomes. Search supports extensive content analysis including topics, keywords, and conversation insights. All timestamps use ISO 8601 format with timezone information.