provider Search POST /crm/v3/objects/contacts/search
@utdk/hubspot /crm/v3/objects/contacts/search
Search for contacts
Search for contacts by filtering on properties, searching through associations, and sorting results. Learn more about [CRM search](https://developers.hubspot.com/docs/guides/api/crm/search#make-a-search-request).

Try it

Authentication
Configure credentials for Contacts
Gateway
The gateway proxies requests and injects credentials server-side. Configure credentials above, then enter your gateway URL.

Saved automatically to browser storage.

post.crm.v3.objects.contacts.searchDosearch
POST/crm/v3/objects/contacts/search
Search for contacts by filtering on properties, searching through associations, and sorting results. Learn more about [CRM search](https://developers.hubspot.com/docs/guides/api/crm/search#make-a-search-request).

Input

required

A paging cursor token for retrieving subsequent pages.

required

Up to 6 groups of filters defining additional query criteria.

required

The maximum results to return, up to 200 objects.

required

A list of property names to include in the response.

The search query string, up to 3000 characters.

required

Specifies sorting order based on object properties.

Enter a gateway URL above to enable sending.

Code snippet
Updates live as you fill in the form above.

TypeScript

import hubspot from '@utdk/hubspot';

await hubspot.post.crm.v3.objects.contacts.searchDosearch()