gong_list_calls
gong_list_calls
Retrieves a list of call recordings from your Gong account with optional date filtering. Use this tool to discover available calls before retrieving transcripts or creating minds.
This tool provides quick access to your Gong call library. Filter by date range to find specific calls, then use the returned call IDs to retrieve transcripts or call details.
Prerequisites
Gong Integration Required
This tool requires Gong integration to be configured. See the Gong Setup Guide for configuration instructions.
Parameters
fromDate
toDate
limit
Request
Response
Response Properties
Common Use Cases
Find Recent Calls
Discover calls from a specific time period to create minds or analyze conversations.
Example:
Natural language workflow:
- AI uses
gong_list_callswith date filter for last 7 days - Returns list of recent calls with participants
- You can then select specific calls for transcript retrieval
What you get:
- Call IDs for transcript retrieval
- Participant information
- Call durations and dates
- Quick overview of recent activity
Discovery Before Mind Creation
Find calls with specific people before creating minds from their conversations.
Example:
Natural language workflow:
- AI lists calls from Q4
- Filters to those with external participants
- Identifies enterprise prospects based on context
- Provides call list for selection
What you get:
- List of relevant calls
- Participant details for each call
- Ability to select which calls to use for mind creation
Call Inventory & Analysis
Build an inventory of calls for reporting or analysis purposes.
Example:
Natural language workflow:
- AI lists all calls from current month
- Analyzes titles to categorize call types
- Provides breakdown and statistics
What you get:
- Complete call inventory
- Call categorization
- Participant trends
- Activity patterns
Error Responses
401 Unauthorized
Solution: Verify your Gong Access Key and Access Key Secret are configured correctly. See the Gong Setup Guide.
400 Bad Request - Invalid Date
Solution: Ensure dates are in ISO 8601 format: YYYY-MM-DD (e.g., 2024-11-15).
429 Rate Limit Exceeded
Solution: Wait for the specified time (in seconds) before retrying. Reduce request frequency or use date filtering to narrow results.
404 No Calls Found
Solution: This is not an error—it means no calls match your filter criteria. Try:
- Widening the date range
- Removing date filters entirely
- Verifying your Gong account has recorded calls
- Checking your user permissions in Gong
Best Practices
Use Date Filters
- Start with narrow date ranges to reduce result sets
- Use recent dates (last week, last month) for quicker responses
- Widen date ranges only when searching for older calls
- Remember Gong API rate limits apply to result size
Pagination Strategy
- Use
limitto control result size - Check
hasMoreto see if additional calls exist - For large call libraries, filter by date rather than paginating
- Save call IDs for later retrieval rather than re-listing
Efficient Discovery
- List calls first, then retrieve transcripts only for selected calls
- Use participant info to pre-filter before transcript retrieval
- Check call duration to prioritize longer, more substantive calls
- Review call titles to identify relevant conversations
Integration with Mind Reasoner
Typical Workflow
Natural language example:
AI orchestrates the entire workflow automatically.
