# Object Get

HubSpot

Retrieve a HubSpot CRM record by object type and record identifier.

## 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 Object Get (tool ID: hubspot.object-get). 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**

Retrieves one CRM record by numeric object type and record id, with optional selected properties, property history and associated record ids. Always one upstream request at $0.0025.

**Inputs and outputs**

### Input

`path` object · required

Identifier path for the authorised connected-app record.

`query` object · optional

Search terms used to find relevant records.

### Output

`archived` boolean

Returned archived value.

`id` string

Returned id value.

`properties` object

Returned properties 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.object-get",
  "input": {
    "path": {
      "objectId": "YOUR-HUBSPOT-OBJECT-ID",
      "objectType": "0-2"
    },
    "query": {
      "properties": "name,domain,description"
    }
  }
}
```

### Output

```
{
  "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/object-get