hubspot_crm_search
Search HubSpot CRM records across all object types using filters, sorts, and full-text queries. Retrieve specific properties with up to 5 filter groups.
Instructions
Search HubSpot CRM records using filters, sorts, and full-text query. Applies to all object types. Supports up to 5 filter groups (OR-ed) with up to 6 filters per group (AND-ed). IMPORTANT NOTES: (1) Search has stricter rate limits (~5 req/s per token) than regular reads — avoid polling. (2) Search has an indexing latency of several seconds — do NOT use immediately after create/update. Use hubspot_crm_get instead for read-after-write. (3) Max total results via paging: 10 000. (4) Specify properties explicitly — HubSpot returns only defaults otherwise. Returns matching records with their requested properties.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| after | No | Pagination cursor. Use 0 (or omit) for first page. | |
| limit | No | Records per response (1–200). Default: 10. | |
| query | No | Full-text search query across all searchable string properties. | |
| sorts | No | Sort specifications applied in order. | |
| objectType | Yes | CRM object type. Sales objects: deals, line_items, products, quotes. Engagement objects: calls, meetings, tasks, notes, emails. | |
| properties | No | Property names to return. Always specify — HubSpot omits non-default properties. | |
| filterGroups | No | OR-ed filter groups (max 5). Each group contains AND-ed filters (max 6). Leave empty with a `query` for full-text-only search. |