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.

• Get records action
• Get owner by ID action
• Get contacts associated with a company action
• Get contacts in contact list action

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

• 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

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

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

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.