ghl_contact_list
Retrieve a paginated list of GoHighLevel contacts for a location, filtered by an optional free-text query; intended for legacy contact listing rather than advanced search.
Instructions
Deprecated by GoHighLevel — prefer ghl_contact_search_advanced (POST /contacts/search) for new integrations. Kept registered for legacy callers. Returns a simple paginated list filtered by an optional free-text query, not the advanced filter/sort search. [DEPRECATED per official docs — prefer the documented replacement if one exists.] [LEGACY FALLBACK — this endpoint is no longer in the live v3 docs (checked 2026-10-28) but is still served under the legacy Version header. Expect removal; prefer a current equivalent.] Get Contacts Get Contacts
Note: This API endpoint is deprecated. Please use the Search Contacts endpoint instead. Endpoint: GET /contacts/ (Version header: 2021-07-28; source: contacts.json) OAuth scopes: contacts.readonly Pagination params: startAfterId, startAfter, 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_contact_list"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Limit Per Page records count. will allow maximum up to 100 and default will be 20 | |
| query | No | Contact Query | |
| locationId | Yes | Location Id | |
| startAfter | No | Start Afte | |
| startAfterId | No | Start After Id |