search_calls
Search Gong calls with filters for date, participants, customer, topic, and duration. Narrow down relevant calls before retrieving summaries or transcripts.
Instructions
Search Gong calls with rich filters. The primary tool for narrowing down calls before drilling in with get_call_summary or get_call_transcript.
Supported filters:
When: fromDateTime, toDateTime (ISO 8601). Always prefer a date range — unbounded queries pull every call in the workspace.
Who hosted: primaryUserIds, primaryUserEmails, excludePrimaryUserIds.
Who participated (host OR attendee OR invitee): participantUserIds, participantEmails, excludeParticipantUserIds, excludeParticipantEmails.
Customer/topic: customerName (CRM account name, email domain, or title substring), titleContains, trackers (see note below).
Metadata: scope (External/Internal), direction, system (Zoom/Meet/…), language (eng/jpn/…), minDuration and maxDuration in seconds.
Output shape: include (array of keyPoints, trackers, highlights, speakers, comments, context, outline, media). Parties + brief + topics are always returned.
Behavior:
Auto-paginates up to ~5000 calls. If a user asks for a broad question, guide them to narrow with a date range, scope, minDuration, or customerName first.
trackers filter does case-insensitive substring match on tracker names. Names are workspace-specific — call get_trackers first to see what's configured before guessing.
When the rich output would exceed the output cap, the tool auto-falls back to a compact table showing all IDs/titles. Use get_call_summary on specific IDs to go deeper.
Filters compose with AND logic (primaryUserIds + customerName = hosted by user X on customer Y calls).
Usage pattern: narrow with search_calls → drill into specific calls with get_call_summary (AI summary) or get_call_transcript (exact quotes).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| scope | No | Filter by call scope: External (customer-facing), Internal (team), or Unknown. | |
| system | No | Filter by conferencing system (e.g., "Zoom", "Google Meet"). Case-insensitive substring match. | |
| callIds | No | Filter by specific call IDs. Array of numeric strings. | |
| include | No | Additional per-call data beyond the defaults (parties, brief, topics). Start lean and add fields as needed — each extra field multiplies response size by number of calls. Options: keyPoints (~5KB/call), trackers (~3KB/call, auto-added when trackers filter is used), highlights (~3KB/call), speakers (talk time, ~1KB/call), comments (varies), context (CRM links, ~1KB/call), outline (~80KB/call, AVOID unless you need full structure of one call), media (audio/video URLs). | |
| language | No | Filter by language code (e.g., "eng", "jpn"). Case-insensitive exact match. | |
| trackers | No | Filter calls where at least one matching tracker fired (count > 0). Tracker names are matched case-insensitive substring and vary by workspace — call get_trackers first to discover what is configured. | |
| direction | No | Filter by call direction: Inbound, Outbound, Conference, or Unknown. | |
| toDateTime | No | End date/time filter in ISO 8601 format (e.g., 2024-01-31T23:59:59Z). Strongly recommended alongside fromDateTime. Must be after fromDateTime if both specified. | |
| maxDuration | No | Maximum call duration in seconds. | |
| minDuration | No | Minimum call duration in seconds. Useful for filtering out no-shows or misfired meetings. | |
| workspaceId | No | Filter calls by workspace ID (numeric string up to 20 digits) | |
| customerName | No | Filter by customer/account name (case-insensitive substring match). Searches CRM account name, external participant email domains, and call titles. | |
| fromDateTime | No | Start date/time filter in ISO 8601 format (e.g., 2024-01-01T00:00:00Z). Strongly recommended — without a date range, the tool pulls every call in the workspace. Must be before toDateTime if both specified. | |
| titleContains | No | Filter calls whose title contains this substring (case-insensitive). | |
| primaryUserIds | No | Filter by primary user IDs (call hosts only, server-side). Use participantUserIds to find calls where a user was any participant. | |
| participantEmails | No | Filter by participant email addresses (case-insensitive). Matches calls where any participant has a matching email. | |
| primaryUserEmails | No | Filter by host email (case-insensitive). Alternative to primaryUserIds when you have emails instead of user IDs. | |
| participantUserIds | No | Filter by participant user IDs. Matches calls where any participant (host, attendee, or invitee) has a matching Gong user ID. Requires a date range for optimal performance. | |
| excludePrimaryUserIds | No | Exclude calls hosted by these user IDs. | |
| excludeParticipantEmails | No | Exclude calls where any participant has a matching email (case-insensitive). | |
| excludeParticipantUserIds | No | Exclude calls where any participant has a matching user ID. |