HubSpot - Get Object

↩ Part of the HubSpot integration.

Description

Reads a single record from the HubSpot CRM by its id (GET /crm/v3/objects/{object_type}/{id}).

By default HubSpot returns only a small set of default properties. Use the properties parameter to name exactly the ones your flow needs — it keeps the payload small and makes the following nodes easier to write.

Configuration

Field	Type	Required	Description
`credentials_id`	credentials	Yes	HubSpot credential
`object_type`	text	Yes	Object type: `contacts`, `companies`, `deals`, `tickets`. Defaults to `contacts` if left empty
`object_id`	text	Yes	Id of the object to read
`properties`	text	No	Properties to return, comma-separated (e.g. `email,firstname`)

All three text fields accept dynamic variables, so object_id is normally {{data.id}} coming from a previous node.

Credentials

This module requires a HubSpot credential:

Field	Description
`token`	Private App token (starts with `pat-`), from HubSpot → Settings → Integrations → Private Apps

Output

data is the HubSpot object:

{
  "id": "701",
  "properties": {
    "email": "ana@acme.com",
    "firstname": "Ana",
    "lastmodifieddate": "2026-08-05T11:22:00.000Z",
    "hs_object_id": "701"
  },
  "createdAt": "2026-08-05T10:00:00.000Z",
  "updatedAt": "2026-08-05T11:22:00.000Z",
  "archived": false
}

Along with it, _meta:

{ "moduleVersion": "1.0.0", "success": true, "id": "701", "objectType": "contacts", "totalMs": 180 }

Usage Example

Read a contact with selected properties

{
  "credentials_id": "hubspot_marketing",
  "object_type": "contacts",
  "object_id": "{{data.contactId}}",
  "properties": "email,firstname,lastname,phone,lifecyclestage"
}

Read the deal that triggered the flow

{
  "credentials_id": "hubspot_sales",
  "object_type": "deals",
  "object_id": "{{data.objectId}}",
  "properties": "dealname,amount,dealstage,closedate"
}

Read a company with the defaults

{
  "credentials_id": "hubspot_marketing",
  "object_type": "companies",
  "object_id": "8912345678"
}

Notes

The values in properties are internal property names separated by commas. Anything that is not a real property is ignored by HubSpot rather than raising an error, so a typo shows up as a missing field in the output.
If object_id resolves to an empty value, the node stops with a validation error before calling HubSpot.
An unknown id returns 404, which is not retried. If you are not sure the record exists, use Search objects first.
Archived records are not returned by this endpoint.
The value read here is a single object. To read many at once use List objects or Search objects, which return arrays.

HubSpot: Search objects — find the id when you only have an email or a name.
HubSpot: Update object — modify the record you just read.
HubSpot: List objects — page through many records instead of one.