HUhubspot
Search

Search for leads using specified criteria.

Changed on

Perform a search for leads based on the provided filter groups, properties, and sorting options. The request allows for pagination and can return up to 200 results per page.

post/crm/objects/2026-03/leads/search

Request

Request body

afterstring required

A paging cursor token for retrieving subsequent pages.

limitinteger required

The maximum results to return, up to 200 objects.

propertiesstring[] required

A list of property names to include in the response.

querystring

The search query string, up to 3000 characters.

sortsstring[] required

Specifies sorting order based on object properties.

Response

successful operation

totalinteger required

The number of available results

Changes

  • b0d8bc008db9Revision changes
    • info

      api operation id post-/crm/objects/2026-03/leads/search_doSearch removed and replaced with post-/crm/objects/2026-03/leads/search

  • dc2fdad57f7fRevision changes
    • info

      api operation id post-/crm/objects/2026-03/leads/search_/crm/objects/2026-03/leads/search removed and replaced with post-/crm/objects/2026-03/leads/search_doSearch

Some revisions have not been checked yet.