ghl_conversation_search
Search conversations by query, status, contact, assignee, date, and other filters, then page through matching results with sorting options.
Instructions
Search Conversations Returns a list of all conversations matching the search criteria along with the sort and filter options selected. Endpoint: GET /conversations/search (Version header: v3; source: v3/conversations-v3.json) OAuth scopes: conversations.readonly Pagination params: limit — pass them to page through full result sets.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"locationId": "<locationId>"
},
"name": "ghl_conversation_search"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | Id of the conversation | |
| sort | No | Sort paramater - asc or desc | |
| limit | No | Limit of conversations - Default is 20 | |
| query | No | Search paramater as a string | |
| sortBy | No | The sorting of the conversation to be filtered as - manual messages or all messages | |
| status | No | The status of the conversation to be filtered - all, read, unread, starred | |
| mentions | No | User Id of the mention. Multiple values are comma separated. | |
| contactId | No | Contact Id | |
| followers | No | User IDs of followers to filter conversations by. Multiple IDs can be provided as comma-separated values. | |
| assignedTo | No | User IDs that conversations are assigned to. Multiple IDs can be provided as comma-separated values. Use "unassigned" to fetch conversations not assigned to any user. | |
| locationId | Yes | Location Id | |
| scoreProfile | No | Id of score profile on which conversations should get filtered out, works with scoreProfileMin & scoreProfileMax | |
| startAfterDate | No | Search to begin after the specified date - should contain the sort value of the last document | |
| lastMessageType | No | Type of the last message in the conversation as a string | |
| scoreProfileMax | No | Maximum value for score | |
| scoreProfileMin | No | Minimum value for score | |
| sortScoreProfile | No | Id of score profile on which sortBy.ScoreProfile should sort on | |
| lastMessageAction | No | Action of the last outbound message in the conversation as string. | |
| lastMessageDirection | No | Direction of the last message in the conversation as string. |