Connectors

Search HubSpot CRM

Searches contacts, companies, deals, or tickets through HubSpot's official server-side SDK. The connected private-app token remains sealed server-side.

post/v1/hubspot/search

Request

  • Base URL: / (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /v1/hubspot/search
  • Auth: HTTP bearer

Request body

limitinteger

Maximum records returned (1-25).

objectType'contact' | 'company' | 'deal' | 'ticket' required

CRM object type.

querystring required

HubSpot free-text search query.

Example request

{
  "limit": 10,
  "objectType": "contact",
  "query": "buyer@example.com"
}

Response

HubSpot search result.

objectType'contact' | 'company' | 'deal' | 'ticket' required

Canonical CRM object type.

totalinteger required

Total matching HubSpot records.

Example response

{
  "objectType": "contact",
  "results": [
    {
      "createdAt": "2026-07-31T12:00:00Z",
      "id": "101",
      "updatedAt": "2026-07-31T12:00:00Z"
    }
  ],
  "total": 1
}

Changes

No operation changes recorded.