Actions18
Contact → Search
AI-generatedSummary
Searches GoHighLevel contacts in a location with an optional free-text query, page limit, sort criteria, and pagination cursor. Uses the selected OAuth2 or Private Integration Token credentials to send a POST request to /contacts/search.
Inputs
- Authentication — Choose OAuth2 or Private Integration Token authentication; defaults to Private Integration Token.
- Location ID (required) — The GoHighLevel sub-account (location) ID.
- Search Query — Free-text search across contact name, email, and phone.
- Page Limit — Maximum results per page, from 1 to 100; defaults to 20.
- Sort — Add sort criteria using Created At, Email, First Name, Last Name, or Updated At, each in ascending or descending order. The field defaults to Created At and direction to descending.
- Search After Cursor — An array cursor copied from
searchAfterin a previous response, used to request the next page.
Output shape
A response object from the GoHighLevel contacts search endpoint.
The operation sends the location ID, query, page limit, sort criteria, and cursor in the request body. The response shape and whether it contains contact records or a next-page cursor are determined by the API response.