Search contacts
ghl_search_contactsSearch GoHighLevel contacts by name, email, or phone with pagination support. Returns matching contact records from a specified location.
Instructions
Search/list contacts in a GoHighLevel location. Supports a free-text query (matches name, email, phone) and pagination. Returns matching contacts.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "ghl_search_contacts"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max contacts to return (1-100). | |
| query | No | Free-text search across name, email, and phone. | |
| locationId | No | GHL Location (sub-account) ID. Defaults to GHL_LOCATION_ID. | |
| startAfter | No | Timestamp cursor to paginate after (from a previous page). | |
| startAfterId | No | Contact id to paginate after (from a previous page). |