---
name: "hubspot_get"
area: "hubspot"
title: "Get a HubSpot record"
price: "free"
method: "POST"
url: "https://api.conecto.chat/v1/tools/hubspot_get"
mcp_server: "https://api.conecto.chat/mcp/hubspot"
auth: "Authorization: Bearer <conecto_sk_ key>"
docs_url: "https://conecto.chat/tools/hubspot/hubspot_get"
---

# Get a HubSpot record (`hubspot_get`)

One HubSpot record by its id, with its usual properties or the ones named.

One contact, company, deal or ticket by its HubSpot id, with its usual properties or the ones named. Free.

Price: Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads. A call that fails costs nothing.

## Use it when

A search found the record and the agent needs its details.

## Say this to your agent

> Show me the combi steamer deal for Hotel Seeblick.

## Inputs

| Name | Type | Required | Description | Allowed values | Default |
|---|---|---|---|---|---|
| `object` | string | yes | contacts, companies, deals or tickets. | `"contacts"`, `"companies"`, `"deals"`, `"tickets"` |  |
| `id` | string | yes | The record's HubSpot id. 1 to 40 characters, matches ^[0-9]+$. |  |  |
| `properties` | array of strings | no | The properties to show; the usual ones when left out. Up to 50 items. |  |  |

## Example

Written for Hansen & Voss, a restaurant-equipment wholesaler in Hamburg with 60 staff.

MCP: call `hubspot_get` on the MCP server `https://api.conecto.chat/mcp/hubspot` with these arguments:

```json
{
  "object": "deals",
  "id": "18734511204"
}
```

REST:

```bash
curl https://api.conecto.chat/v1/tools/hubspot_get \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"object": "deals", "id": "18734511204"}'
```

## Response

```json
{
  "call_id": "5f0c8a2e-3b7d-4c1e-9a64-2d8e1f7b0c93",
  "tool": "hubspot_get",
  "status": "succeeded",
  "replayed": false,
  "cost_usd": "$0.00",
  "balance_usd": "$19.75",
  "result": {
    "record": {
      "id": "18734511204",
      "object": "deals",
      "properties": {
        "dealname": "Combi steamers, Hotel Seeblick",
        "amount": "18400",
        "dealstage": "appointmentscheduled",
        "pipeline": "default"
      },
      "created_at": "2026-09-02T10:00:00Z",
      "updated_at": "2026-10-01T09:00:00Z"
    }
  }
}
```

`result`: record: id, object, properties, created_at and updated_at.

## Errors

| Code | Status | When | Fix |
|---|---|---|---|
| `not_connected` | 409 | HubSpot isn't connected yet. | Connect it with hubspot_connect. |
| `vendor_rejected` | 502 | HubSpot refused: the token is wrong, or the private app lacks the scope. | Add the scope the message names to the private app. |
| `not_found` | 404 | HubSpot has no record with that id. | Search first and use its id. |

The refusals every tool can give (401 key, 402 balance, 429 limits) are on the errors page: https://conecto.chat/docs/errors.md

## Related

- [hubspot_connect](https://conecto.chat/tools/hubspot/hubspot_connect.md): Connects the company's HubSpot through its own private app's token. Free.
- [hubspot_search](https://conecto.chat/tools/hubspot/hubspot_search.md): Contacts, companies, deals or tickets in HubSpot matching words. Free up to 1,000,000 reads a month.
- [hubspot_create](https://conecto.chat/tools/hubspot/hubspot_create.md): Makes a contact, company, deal or ticket in HubSpot. $0.001 a call.
- [hubspot_update](https://conecto.chat/tools/hubspot/hubspot_update.md): Changes a HubSpot record's properties; waits for the owner by default. $0.001 a call.
- [hubspot_add_note](https://conecto.chat/tools/hubspot/hubspot_add_note.md): Adds a note to a HubSpot record's timeline, where the team sees it. $0.001 a call.
- [hubspot_disconnect](https://conecto.chat/tools/hubspot/hubspot_disconnect.md): Forgets the private app's token; nothing in HubSpot changes. Free.