# Objects Search

HubSpot

Search records of a selected HubSpot CRM object type by property filters and sorting.

## Use this tool with your AI agent

1. Copy the prompt
2. Paste it into your agent
3. Tell it what you need

Read https://scrollport.com/start. Use my existing Scrollport connection, or help me connect if needed. Help me use Objects Search (tool ID: hubspot.objects-search). Ask me for the details you need, then show me the result. Help me connect the required app account if needed.

**Already connected:** Your agent can use that connection.

**New user:** Your agent will guide you through setup, sign-in and authorisation.

This tool also needs you to connect your app account.

Connect your first agent to receive $1 trial credit.

**Job:** [Manage HubSpot records](https://scrollport.com/tools/hubspot-mcp)

**Current price:** $0.0025/request

**Availability:** Requires connected account

## Tool details

**About this tool**

Searches one supported standard or custom CRM object type using a free-text query, filter groups, sorts and selected properties. Scrollport owns the paging cursor; each upstream page costs $0.0025.

**Inputs and outputs**

### Input

`body` object · required

Bounded request body sent to the connected application.

`max_pages` integer · optional

Maximum number of result pages to request.

minimum: 1 · maximum: 10

`path` object · required

Identifier path for the authorised connected-app record.

### Output

`pages` number

Returned pages value.

`results` array

Returned results value.

**Example request and output**

Inspect returns this reviewed example, its estimated cost and the current input schema. Run calculates the estimate for your actual input.

### Request

```
{
  "tool_id": "hubspot.objects-search",
  "input": {
    "body": {
      "limit": 1,
      "properties": [
        "name",
        "domain",
        "description"
      ],
      "filterGroups": [
        {
          "filters": [
            {
              "value": "YOUR-HUBSPOT-OBJECT-ID",
              "operator": "EQ",
              "propertyName": "hs_object_id"
            }
          ]
        }
      ]
    },
    "path": {
      "objectType": "0-2"
    },
    "max_pages": 1
  }
}
```

### Output

```
{
  "pages": 1,
  "results": [
    {
      "id": "400000000001",
      "archived": false,
      "properties": {
        "name": "Northstar Research (Sample)",
        "domain": "northstar-research.invalid",
        "description": "Research partner profile used to demonstrate CRM retrieval and updates."
      }
    }
  ]
}
```

**Errors and limitations**

- `connection_required`: This capability acts on your own HubSpot account, which isn't connected yet.Open connect_url, approve access, then retry this run unchanged.
- `permission_required`: The connected HubSpot grant does not include a scope required by this object type.Reconnect HubSpot and approve the requested scope, or choose an object type available to this account.

---

Canonical page: https://scrollport.com/tools/providers/hubspot/objects-search