# HubSpot - Get object actions

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

# Objects supported

Workato currently supports the get action for these objects.

# Get company by ID

This action retrieves details of the specific company that matches a search by company ID.

Get company by ID action

Get company by ID action

# Input fields

Input field Description
Company ID The unique ID of the company.

# Output fields

If the request is successful, Workato will return an object representing the specific company matching the ID provided so you can use its datapills in the subsequent steps. Click here to view the fields available.

# Get contact by VID

This action retrieves details of the specific contact that matches a search by the contact VID. Additionally, you may select whether you would like to retrieve the version history of fields and/or the list memberships of the contact.

Get contact by VID action

Get contact by VID action

# Input fields

Input field Description
Contact ID The unique ID of the contact.
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 an object representing the specific contact matching the VID provided 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 contact by email

This action retrieves details of the specific contact that matches a search by the contact email. Additionally, you may select whether you would like to retrieve the version history of fields and/or the list memberships of the contact, requests will only return a single contact.

Get contact by email action

Get contact by email action

# Input fields

Input field Description
Contact email The email of the contact.
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 an object representing the specific contact that matches the email address provided 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 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 deal by ID

This action retrieves details of a specific deal in HubSpot that corresponds to the given deal ID.

Get deal by ID action

Get deal by ID action

# Input fields

Input field Description
Deal ID The ID of the deal to be retrieved.
Include property versions Select whether to retrieve the current value for each deal property or to retrieve both current value and every historical value.

# Output fields

If the request is successful, Workato will return an object representing the specific deal matching the ID provided 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 email

This action retrieves all owners in a HubSpot account that matches the given email address. Additionally, you may select whether or not to retrieve inactive 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 email action

Get owner by email action

# Input fields

Input field Description
Email address The email address belonging to an owner.
Include inactive Select whether to retrieve owners without any active remotes.

# Output fields

If the request is successful, Workato will return a list of owners that match the email address provided 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.