Action Reference for HubSpot Connector

Actions are used by a workflow to to download, upload, inspect or manipulate data from a system.

Refer to the table below for action details related to the current version of the HubSpot Connector. For earlier versions, see HubSpot Connector Actions - version 3 and lower

Action Name Description Version
Add Entity Data (API v3) Add a new entry/record for the specified entity. This action uses version 3 of the HubSpot CRM API. 4.7+
Associate Objects (API v2) Associate one existing object with another. This action uses version 2 of the HubSpot API.

This action name was updated in version 4.2.0. In earlier versions, this is the same as action name Objects Associate.		 4.0+
Associate two Objects (API v3) Associate one object with another. Both objects must exist. This action uses version 3 of the HubSpot API.

This action name was updated in version 4.2.0. In earlier versions, this is the same as action name Objects Associate V3.		 4.0+
Create a Company (API v2) Create a new HubSpot company. This action uses version 2 of the HubSpot API.

This action name was updated in version 4.2.0. In earlier versions, this is the same as action name Create HubSpot Company.		 4.0+
Create a Company (API v3) Create a company. This action uses the version 3 HubSpot API.

This action name was updated in version 4.2.0. In earlier versions, this is the same as action name Company Create V3.		 4.0+
Create a Contact (API v2) Create a new HubSpot contact. This action uses version 2 of the HubSpot API.

This action name was updated in version 4.2.0. In earlier versions, this is the same as action name Create HubSpot Contact.		 4.0+
Create a Contact (API v3) Create a contact. This action uses the version 3 HubSpot API.

This action name was updated in version 4.2.0. In earlier versions, this is the same as action name Contact Create V3.		 4.0+
Create a Contact and Associate with Company (API v2) Create a new HubSpot contact and associate it with the specified company; create the company if it doesn’t already exist. This action uses version 2 of the HubSpot API.

This action name was updated in version 4.2.0. In earlier versions, this is the same as action name Create HubSpot Contact and Associate with Company.		 4.0+
Create a Deal (API v2) Create a new HubSpot deal. This action uses version 2 of the HubSpot API.

This action name was updated in version 4.2.0. In earlier versions, this is the same as action name Deal Create.		 4.0+
Create a Deal (API v3) Create a deal. This action uses the version 3 HubSpot API.

This action name was updated in version 4.2.0. In earlier versions, this is the same as action name Deal Create V3.		 4.0+
Create a Line Item (API v3) Create a line item. This action uses the version 3 HubSpot API.

This action name was updated in version 4.2.0. In earlier versions, this is the same as action name Line Item Create V3.		 4.1+
Create a Product (API v3) Create a product. This action uses the version 3 HubSpot API.

This action name was updated in version 4.2.0. In earlier versions, this is the same as action name Product Create V3.		 4.0+
Create an Object (API v2) Create a new HubSpot object. This action uses version 2 of the HubSpot API.

This action name was updated in version 4.2.0. In earlier versions, this is the same as action name Create HubSpot Object.		 4.0+
Delete Entity Data (API v3) Delete the specified entity entry/record. This action uses the version 3 HubSpot CRM API. 4.7+
Get a Company (API v3) Retrieve company details for the specified company ID. This action uses the version 3 HubSpot API.

This action name was updated in version 4.2.0. In earlier versions, this is the same as action name Company Get V3.		 4.0+
Get a Company's Associations (API v3) Retrieve a list of associations for the specified company, grouped by type. This action uses the version 3 HubSpot API.

This action name was updated in version 4.2.0. In earlier versions, this is the same as action name Get Company Associations V3.		 4.0+
Get a Company's Details (API v2) Retrieve details for the specified company. This action uses version 2 of the HubSpot API.

This action name was updated in version 4.2.0. In earlier versions, this is the same as action name Get HubSpot Company Details.		 4.0+
Get a Contact (API v3) Retrieve contact details for the specified contact ID. This action uses the version 3 HubSpot API.

This action name was updated in version 4.2.0. In earlier versions, this is the same as action name Contacts Get V3.		 4.0+
Get a Contact's Details (API v2) Retrieve details for the specified contact. This action uses version 2 of the HubSpot API.

This action name was updated in version 4.2.0. In earlier versions, this is the same as action name Get HubSpot Contact Details.		 4.0+
Get a Deal (API v3) Retrieve deal details for the specified deal ID. This action uses the version 3 HubSpot API.

This action name was updated in version 4.2.0. In earlier versions, this is the same as action name Deal Get V3.		 4.0+
Get a Line Item (API v3) Retrieve line item details for the specified line item ID. This action uses the version 3 HubSpot API.

This action name was updated in version 4.2.0. In earlier versions, this is the same as action name Line Item Get V3.		 4.0+
Get a Product (API v3) Retrieve product details for the specified product ID. This action uses the version 3 HubSpot API.

This action name was updated in version 4.2.0. In earlier versions, this is the same as action name Get Product V3.		 4.0+
Get an Entity's Details (API v3) Retrieve details for the specified entity. This action uses version 3 of the HubSpot CRM API. 4.7+
Get an Object's Details (API v2) Retrieve details for the specified object. This action uses version 2 of the HubSpot API.

This action name was updated in version 4.2.0. In earlier versions, this is the same as action name Get HubSpot Object Details.		 4.0+
Get Object Association (API v3) List the specified type of associations belonging to the specified object. For example, get a deal’s associated line_items. This action uses version 3 of the HubSpot API. 4.2+
Get Quote Associations (API v3) Retrieve a list of associations for the specified quote, grouped by type. This action uses the version 3 HubSpot API.

This action name was updated in version 4.2.0. In earlier versions, this is the same as action name Get Quote Associations V3.		 4.0+
Get the Contact List for a Company (API v2) Retrieve a contact list for the specified company. This action uses version 2 of the HubSpot API.

This action name was updated in version 4.2.0. In earlier versions, this is the same as action name Get HubSpot Company Contacts List.		 4.0+
Search Companies Using Filters (API v3) Retrieve a list of companies that match the provided query filters. This action uses the version 3 HubSpot API. 4.4+
Search Contacts Using Filters (API v3) Retrieve a list of contacts that match the provided query filters. Contact details are included in the results. This action uses the version 3 HubSpot API. 4.3+
Search Entities Using Filters (API v3) Retrieve a list of entities that match the provided query filters. This action uses the version 3 HubSpot CRM API. 4.7+
Update a batch of Companies (API v2) Update existing HubSpot companies in a batch. This action uses version 2 of the HubSpot API.

This action name was updated in version 4.2.0. In earlier versions, this is the same as action name Update HubSpot Companies.		 4.0+
Update a Company (API v2) Update an existing company. This action uses version 2 of the HubSpot API.

This action name was updated in version 4.2.0. In earlier versions, this is the same as action name Update HubSpot Company.		 4.0+
Update a Company (API v3) Update an existing company. This action uses the version 3 HubSpot API.

This action name was updated in version 4.2.0. In earlier versions, this is the same as action name Company Update V3.		 4.0+
Update a Contact (API v2) Update an existing contact. This action uses version 2 of the HubSpot API.

This action name was updated in version 4.2.0. In earlier versions, this is the same as action name Update HubSpot Contact.		 4.0+
Update a Contact (API v3) Update an existing contact. This action uses the version 3 HubSpot API.

This action name was updated in version 4.2.0. In earlier versions, this is the same as action name Contact Update V3.		 4.0+
Update a Deal (API v2) Update an existing deal. This action uses version 2 of the HubSpot API.

This action name was updated in version 4.2.0. In earlier versions, this is the same as action name Deal Update.		 4.0+
Update a Deal (API v3) Update an existing deal. This action uses the version 3 HubSpot API.

This action name was updated in version 4.2.0. In earlier versions, this is the same as action name Deal Update V3.		 4.0+
Update a Line Item (API v3) Update an existing line item. This action uses the version 3 HubSpot API.

This action name was updated in version 4.2.0. In earlier versions, this is the same as action name Line Item Update V3.		 4.1+
Update a Product (API v3) Update an existing product. This action uses the version 3 HubSpot API.

This action name was updated in version 4.2.0. In earlier versions, this is the same as action name Product Update V3.		 4.0+
Update an Entity (API v3) Update the specified entity. This action uses the version 3 HubSpot CRM API. 4.7+
Update an Object (API v2) Update an existing HubSpot object. This action uses version 2 of the HubSpot API.

This action name was updated in version 4.2.0. In earlier versions, this is the same as action name Update HubSpot Object.		 4.0+

Action Names

Add Entity Data (API v3)

Action Name Description Version
Add Entity Data (API v3) Add a new entry/record for the specified entity. This action uses version 3 of the HubSpot CRM API. 4.7+

Associate Objects (API v2)

Action Name Description Version
Associate Objects (API v2) Associate one existing object with another. This action uses version 2 of the HubSpot API.

This action name was updated in version 4.2.0. In earlier versions, this is the same as action name Objects Associate.		 4.0+

Associate two Objects (API v3)

Action Name Description Version
Associate two Objects (API v3) Associate one object with another. Both objects must exist. This action uses version 3 of the HubSpot API.

This action name was updated in version 4.2.0. In earlier versions, this is the same as action name Objects Associate V3.		 4.0+

Create a Company (API v2)

Action Name Description Version
Create a Company (API v2) Create a new HubSpot company. This action uses version 2 of the HubSpot API.

This action name was updated in version 4.2.0. In earlier versions, this is the same as action name Create HubSpot Company.		 4.0+

Create a Company (API v3)

Action Name Description Version
Create a Company (API v3) Create a company. This action uses the version 3 HubSpot API.

This action name was updated in version 4.2.0. In earlier versions, this is the same as action name Company Create V3.		 4.0+

Create a Contact (API v2)

Action Name Description Version
Create a Contact (API v2) Create a new HubSpot contact. This action uses version 2 of the HubSpot API.

This action name was updated in version 4.2.0. In earlier versions, this is the same as action name Create HubSpot Contact.		 4.0+

Create a Contact (API v3)

Action Name Description Version
Create a Contact (API v3) Create a contact. This action uses the version 3 HubSpot API.

This action name was updated in version 4.2.0. In earlier versions, this is the same as action name Contact Create V3.		 4.0+

Create a Contact and Associate with Company (API v2)

Action Name Description Version
Create a Contact and Associate with Company (API v2) Create a new HubSpot contact and associate it with the specified company; create the company if it doesn’t already exist. This action uses version 2 of the HubSpot API.

This action name was updated in version 4.2.0. In earlier versions, this is the same as action name Create HubSpot Contact and Associate with Company.		 4.0+

Create a Deal (API v2)

Action Name Description Version
Create a Deal (API v2) Create a new HubSpot deal. This action uses version 2 of the HubSpot API.

This action name was updated in version 4.2.0. In earlier versions, this is the same as action name Deal Create.		 4.0+

Create a Deal (API v3)

Action Name Description Version
Create a Deal (API v3) Create a deal. This action uses the version 3 HubSpot API.

This action name was updated in version 4.2.0. In earlier versions, this is the same as action name Deal Create V3.		 4.0+

Create a Line Item (API v3)

Action Name Description Version
Create a Line Item (API v3) Create a line item. This action uses the version 3 HubSpot API.

This action name was updated in version 4.2.0. In earlier versions, this is the same as action name Line Item Create V3.		 4.1+

Create a Product (API v3)

Action Name Description Version
Create a Product (API v3) Create a product. This action uses the version 3 HubSpot API.

This action name was updated in version 4.2.0. In earlier versions, this is the same as action name Product Create V3.		 4.0+

Create an Object (API v2)

Action Name Description Version
Create an Object (API v2) Create a new HubSpot object. This action uses version 2 of the HubSpot API.

This action name was updated in version 4.2.0. In earlier versions, this is the same as action name Create HubSpot Object.		 4.0+

Delete Entity Data (API v3)

Action Name Description Version
Delete Entity Data (API v3) Delete the specified entity entry/record. This action uses the version 3 HubSpot CRM API. 4.7+

Get a Company (API v3)

Action Name Description Version
Get a Company (API v3) Retrieve company details for the specified company ID. This action uses the version 3 HubSpot API.

This action name was updated in version 4.2.0. In earlier versions, this is the same as action name Company Get V3.		 4.0+

Get a Company’s Associations (API v3)

Action Name Description Version
Get a Company's Associations (API v3) Retrieve a list of associations for the specified company, grouped by type. This action uses the version 3 HubSpot API.

This action name was updated in version 4.2.0. In earlier versions, this is the same as action name Get Company Associations V3.		 4.0+

Get a Company’s Details (API v2)

Action Name Description Version
Get a Company's Details (API v2) Retrieve details for the specified company. This action uses version 2 of the HubSpot API.

This action name was updated in version 4.2.0. In earlier versions, this is the same as action name Get HubSpot Company Details.		 4.0+

Get a Contact (API v3)

Action Name Description Version
Get a Contact (API v3) Retrieve contact details for the specified contact ID. This action uses the version 3 HubSpot API.

This action name was updated in version 4.2.0. In earlier versions, this is the same as action name Contacts Get V3.		 4.0+

Get a Contact’s Details (API v2)

Action Name Description Version
Get a Contact's Details (API v2) Retrieve details for the specified contact. This action uses version 2 of the HubSpot API.

This action name was updated in version 4.2.0. In earlier versions, this is the same as action name Get HubSpot Contact Details.		 4.0+

Get a Deal (API v3)

Action Name Description Version
Get a Deal (API v3) Retrieve deal details for the specified deal ID. This action uses the version 3 HubSpot API.

This action name was updated in version 4.2.0. In earlier versions, this is the same as action name Deal Get V3.		 4.0+

Get a Line Item (API v3)

Action Name Description Version
Get a Line Item (API v3) Retrieve line item details for the specified line item ID. This action uses the version 3 HubSpot API.

This action name was updated in version 4.2.0. In earlier versions, this is the same as action name Line Item Get V3.		 4.0+

Get a Product (API v3)

Action Name Description Version
Get a Product (API v3) Retrieve product details for the specified product ID. This action uses the version 3 HubSpot API.

This action name was updated in version 4.2.0. In earlier versions, this is the same as action name Get Product V3.		 4.0+

Get an Entity’s Details (API v3)

Action Name Description Version
Get an Entity's Details (API v3) Retrieve details for the specified entity. This action uses version 3 of the HubSpot CRM API. 4.7+

Get an Object’s Details (API v2)

Action Name Description Version
Get an Object's Details (API v2) Retrieve details for the specified object. This action uses version 2 of the HubSpot API.

This action name was updated in version 4.2.0. In earlier versions, this is the same as action name Get HubSpot Object Details.		 4.0+

Get Object Association (API v3)

Action Name Description Version
Get Object Association (API v3) List the specified type of associations belonging to the specified object. For example, get a deal’s associated line_items. This action uses version 3 of the HubSpot API. 4.2+

Get Quote Associations (API v3)

Action Name Description Version
Get Quote Associations (API v3) Retrieve a list of associations for the specified quote, grouped by type. This action uses the version 3 HubSpot API.

This action name was updated in version 4.2.0. In earlier versions, this is the same as action name Get Quote Associations V3.		 4.0+

Get the Contact List for a Company (API v2)

Action Name Description Version
Get the Contact List for a Company (API v2) Retrieve a contact list for the specified company. This action uses version 2 of the HubSpot API.

This action name was updated in version 4.2.0. In earlier versions, this is the same as action name Get HubSpot Company Contacts List.		 4.0+

Search Companies Using Filters (API v3)

Action Name Description Version
Search Companies Using Filters (API v3) Retrieve a list of companies that match the provided query filters. This action uses the version 3 HubSpot API. 4.4+

This action searches using the configured filters and search terms, and saves the results using the option “Save Action Output to Workflow Messages”. Enable and configure this option to use the search results in another action.

When configuring search Filter Groups, Filters within each Filter Group are combined using the “AND” logical operator while Filter Groups are combined using the “OR” logical operator.

As an example: Using the following settings, search results would include companies which match the filter group “The domain contains .net AND the number of employees” or which match the filter group “Total revenue is greater than 10000”.

Search Companies Using Filters (API v3) Action

Properties included by default are listed below. Additional properties may be added using the “Properties to Add” action setting.

  • about_us
  • address
  • address2
  • annualrevenue
  • b1_account_on_hold
  • b1_card_name
  • b1_cloud_customer
  • b1_country
  • b1_current_on_support
  • b1_customer_end_date
  • b1_customer_start_date
  • b1_db
  • b1_hana
  • b1_industry
  • b1_lead_source
  • b1_primary_contact
  • b1_region
  • b1_sales_person
  • b1_sap_name
  • b1_ship_to_street_address
  • b1_ship_to_street_address_2
  • b1_ship_to_street_address_3
  • b1_ship_to_zipcode
  • b1_subindustry
  • b1support_perpetual_saas
  • city
  • closedate
  • closedate_timestamp_earliest_value_a2a17e6e
  • country
  • createdate
  • days_to_close
  • description
  • domain
  • engagements_last_meeting_booked
  • engagements_last_meeting_booked_campaign
  • engagements_last_meeting_booked_medium
  • engagements_last_meeting_booked_source
  • facebook_company_page
  • facebookfans
  • first_contact_createdate
  • first_contact_createdate_timestamp_earliest_value_78b50eea
  • first_conversion_date
  • first_conversion_date_timestamp_earliest_value_61f58f2c
  • first_conversion_event_name
  • first_conversion_event_name_timestamp_earliest_value_68ddae0a
  • first_deal_created_date
  • founded_year
  • googleplus_page
  • hs_additional_domains
  • hs_all_accessible_team_ids
  • hs_all_owner_ids
  • hs_all_team_ids
  • hs_analytics_first_timestamp
  • hs_analytics_first_timestamp_timestamp_earliest_value_11e3a63a
  • hs_analytics_first_touch_converting_campaign
  • hs_analytics_first_touch_converting_campaign_timestamp_earliest_value_4757fe10
  • hs_analytics_first_visit_timestamp
  • hs_analytics_first_visit_timestamp_timestamp_earliest_value_accc17ae
  • hs_analytics_last_timestamp
  • hs_analytics_last_timestamp_timestamp_latest_value_4e16365a
  • hs_analytics_last_touch_converting_campaign
  • hs_analytics_last_touch_converting_campaign_timestamp_latest_value_81a64e30
  • hs_analytics_last_visit_timestamp
  • hs_analytics_last_visit_timestamp_timestamp_latest_value_999a0fce
  • hs_analytics_num_page_views
  • hs_analytics_num_page_views_cardinality_sum_e46e85b0
  • hs_analytics_num_visits
  • hs_analytics_num_visits_cardinality_sum_53d952a6
  • hs_analytics_source
  • hs_analytics_source_data_1
  • hs_analytics_source_data_1_timestamp_earliest_value_9b2f1fa1
  • hs_analytics_source_data_2
  • hs_analytics_source_data_2_timestamp_earliest_value_9b2f9400
  • hs_analytics_source_timestamp_earliest_value_25a3a52c
  • hs_avatar_filemanager_key
  • hs_created_by_user_id
  • hs_createdate
  • hs_ideal_customer_profile
  • hs_is_target_account
  • hs_last_booked_meeting_date
  • hs_last_logged_call_date
  • hs_last_open_task_date
  • hs_last_sales_activity_date
  • hs_last_sales_activity_timestamp
  • hs_lastmodifieddate
  • hs_latest_meeting_activity
  • hs_lead_status
  • hs_merged_object_ids
  • hs_num_blockers
  • hs_num_child_companies
  • hs_num_contacts_with_buying_roles
  • hs_num_decision_makers
  • hs_num_open_deals
  • hs_object_id
  • hs_parent_company_id
  • hs_predictivecontactscore_v2
  • hs_predictivecontactscore_v2_next_max_max_d4e58c1e
  • hs_sales_email_last_replied
  • hs_target_account
  • hs_target_account_probability
  • hs_target_account_recommendation_snooze_time
  • hs_target_account_recommendation_state
  • hs_total_deal_value
  • hs_updated_by_user_id
  • hs_user_ids_of_all_owners
  • hubspot_owner_assigneddate
  • hubspot_owner_id
  • hubspot_team_id
  • hubspotscore
  • industry
  • is_public
  • lifecyclestage
  • linkedin_company_page
  • linkedinbio
  • name
  • notes_last_contacted
  • notes_last_updated
  • notes_next_activity_date
  • num_associated_contacts
  • num_associated_deals
  • num_contacted_notes
  • num_conversion_events
  • num_conversion_events_cardinality_sum_d095f14b
  • num_notes
  • numberofemployees
  • owneremail
  • ownername
  • phone
  • recent_conversion_date
  • recent_conversion_date_timestamp_latest_value_72856da1
  • recent_conversion_event_name
  • recent_conversion_event_name_timestamp_latest_value_66c820bf
  • recent_deal_amount
  • recent_deal_close_date
  • state
  • timezone
  • total_money_raised
  • total_revenue
  • twitterbio
  • twitterfollowers
  • twitterhandle
  • type
  • user
  • v33_b1_card_code
  • web_technologies
  • website
  • zip

Search Contacts Using Filters (API v3)

Action Name Description Version
Search Contacts Using Filters (API v3) Retrieve a list of contacts that match the provided query filters. Contact details are included in the results. This action uses the version 3 HubSpot API. 4.3+

Search Entities Using Filters (API v3)

Action Name Description Version
Search Entities Using Filters (API v3) Retrieve a list of entities that match the provided query filters. This action uses the version 3 HubSpot CRM API. 4.7+

Update a batch of Companies (API v2)

Action Name Description Version
Update a batch of Companies (API v2) Update existing HubSpot companies in a batch. This action uses version 2 of the HubSpot API.

This action name was updated in version 4.2.0. In earlier versions, this is the same as action name Update HubSpot Companies.		 4.0+

Update a Company (API v2)

Action Name Description Version
Update a Company (API v2) Update an existing company. This action uses version 2 of the HubSpot API.

This action name was updated in version 4.2.0. In earlier versions, this is the same as action name Update HubSpot Company.		 4.0+

Update a Company (API v3)

Action Name Description Version
Update a Company (API v3) Update an existing company. This action uses the version 3 HubSpot API.

This action name was updated in version 4.2.0. In earlier versions, this is the same as action name Company Update V3.		 4.0+

Update a Contact (API v2)

Action Name Description Version
Update a Contact (API v2) Update an existing contact. This action uses version 2 of the HubSpot API.

This action name was updated in version 4.2.0. In earlier versions, this is the same as action name Update HubSpot Contact.		 4.0+

Update a Contact (API v3)

Action Name Description Version
Update a Contact (API v3) Update an existing contact. This action uses the version 3 HubSpot API.

This action name was updated in version 4.2.0. In earlier versions, this is the same as action name Contact Update V3.		 4.0+

Update a Deal (API v2)

Action Name Description Version
Update a Deal (API v2) Update an existing deal. This action uses version 2 of the HubSpot API.

This action name was updated in version 4.2.0. In earlier versions, this is the same as action name Deal Update.		 4.0+

Update a Deal (API v3)

Action Name Description Version
Update a Deal (API v3) Update an existing deal. This action uses the version 3 HubSpot API.

This action name was updated in version 4.2.0. In earlier versions, this is the same as action name Deal Update V3.		 4.0+

Update a Line Item (API v3)

Action Name Description Version
Update a Line Item (API v3) Update an existing line item. This action uses the version 3 HubSpot API.

This action name was updated in version 4.2.0. In earlier versions, this is the same as action name Line Item Update V3.		 4.1+

Update a Product (API v3)

Action Name Description Version
Update a Product (API v3) Update an existing product. This action uses the version 3 HubSpot API.

This action name was updated in version 4.2.0. In earlier versions, this is the same as action name Product Update V3.		 4.0+

Update an Entity (API v3)

Action Name Description Version
Update an Entity (API v3) Update the specified entity. This action uses the version 3 HubSpot CRM API. 4.7+

Update an Object (API v2)

Action Name Description Version
Update an Object (API v2) Update an existing HubSpot object. This action uses version 2 of the HubSpot API.

This action name was updated in version 4.2.0. In earlier versions, this is the same as action name Update HubSpot Object.		 4.0+