FlowmageDocs

Get record

BetaReads data

Fetches one HubSpot record by its id or by a unique property.

Settings

SettingWhat it is
ConnectionRequiredThe HubSpot connection the step signs in with.
Object"contacts" or "companies" or "deals" or "tickets" or "notes" or "tasks" or "calls" or "meetings" or "emails" or "leads" or "products" or "line_items" or "custom"
Custom object type idThe object type id, e.g. 2-1234567. The List properties node shows it.
Record idRequiredThe record's HubSpot id, or the value of the unique property named below.
Look up by propertyLeave empty to look the record up by its HubSpot record id. Fill in email to look a contact up by e-mail, or the internal name of any unique-identifier property.
Properties to fetchComma-separated. HubSpot leaves out anything you do not ask for.
Properties with their historyComma-separated. Each one comes back with its previous values too.
Associated objectsComma-separated object names to return associated ids for.
Look in the recycling binDeleted records stay there for 90 days.
Technical details
KeyValue
connectiontexta connection id from `requires.connections` (provider `hubspot`)
object"contacts" or "companies" or "deals" or "tickets" or "notes" or "tasks" or "calls" or "meetings" or "emails" or "leads" or "products" or "line_items" or "custom", by default "contacts"
customObjectTypetextused when `object` is "custom"
recordIdtextits `{{ }}` must give a string
idPropertytext
propertiestext
propertiesWithHistorytext
associationstext
archivedtrue/false, by default false

Output

FieldType
recordobject
recordIdstring
propertiesobject
associationsAssociated recordsobject
Sample output, and the expression for each field
  • associations{}
  • properties
    • email"jane@example.com"
  • record
    • id"1"
  • recordId"1"

Errors

When a step of this node stops a run, the run page shows a code. Look it up:

Example step

The step as a flow file holds it. Replace each value in <…>.

{
  "config": {
    "archived": false,
    "associations": "",
    "connection": "<connection id>",
    "customObjectType": "",
    "idProperty": "",
    "object": "contacts",
    "properties": "",
    "propertiesWithHistory": "",
    "recordId": "<record id>"
  },
  "label": "Get record",
  "type": "hubspot.getRecord",
  "version": 1
}