# HubSpot - Get record actions

These actions will allow you to retrieve records by an object's ID, Email, through associations to other objects or from lists.

Workato currently supports the get action for these objects.

DEPRECATION NOTICE

The following actions have been deprecated. You can access these HubSpot objects with the Get Records action.

  • Get company by ID action
  • Get contact by email action
  • Get contact by VID action
  • Get deal by ID action
  • Get owner by email action

# Get Records

This action allows you to retrieve any object based on its ID. Furthermore, you can select the properties you plan to retrieve from it.

Get records action

Get records action

  • Objects

  • Select which HubSpot object to retrieve.

    View all available HubSpot objects
    • Contact
    • Company
    • Deal
    • Product
    • Ticket
    • Line Item
    • Quote
    • Custom Objects
  • ID

  • The ID of the record to retrieve.

  • Fields to retrieve

  • Only properties selected here will be returned. When left blank, only the default fields will be returned.

# Get contacts associated with a company

This action retrieves all contacts associated with a company in HubSpot in descending order when you provide the company ID. Additionally, you may select whether you would like to retrieve the version history of fields and/or the list memberships of the contact.

Get contacts associated with a company action

Get contacts associated with a company action

# Input fields

Input field Description
Company ID The ID of the company that the contacts are associated to.
Count The number of contacts to be returned in your request.
Property mode Select whether to retrieve the current value for each contact property or to retrieve both current value and every historical value.
Show list members Select an option to indicate whether current list members should be retrieved for the contact. The default is true.
Properties The unique ID of the contact.

# Output fields

If the request is successful, Workato will return a list of objects representing the contacts associated with the selected company so you can use its datapills in the subsequent steps, the values of each property retrieved is determined by the input fields of the action. Click here to view the fields available.

# Get contacts in contact list

This action retrieves all details about contacts in a specific contact list in HubSpot.

Get contacts in contact list action

Get contacts in contact list action

# Input fields

Input field Description
List List from which you want to retrieve contacts.
Property mode Select whether to retrieve the current value for each contact property or to retrieve both current value and every historical value.
Show list members Select an option to indicate whether current list members should be retrieved for the contact. The default is true.
Properties The unique ID of the contact.

# Output fields

If the request is successful, Workato will return a list of objects representing the contacts in the selected contact list so you can use its datapills in the subsequent steps, the values of each property retrieved is determined by the input fields of the action. Click here to view the fields available.

# Get owner by ID

This action retrieves all owners in a HubSpot account that matches the given ID. Additionally, you may select whether or not to retrieve archived owners. HubSpot uses owners to assign specific users to contacts, companies, deals, tickets, or engagements. Any HubSpot user with access to contacts can be assigned as an owner, and multiple owners can be assigned to an object by creating a custom property for this purpose.

Get owner by id action

Get owner by ID action

# Input fields

Input field Description
ID The ID of an owner.
Archived Choose yes to return only results that have been archived. Default is No.

# Output fields

If the request is successful, Workato will return information about the owner that matches the ID provided so you can use its datapills in the subsequent steps. Click here to view the fields available.


Last updated: 5/11/2024, 8:17:13 PM