Skip to main content
Back to list of enterprise systems Use the HubSpot integration to manage CRM records, lists, workflows, associations, subscriptions, files, and website content through Action Tools. HubSpot also provides triggers for CRM changes, form submissions, email activity, and other events.

Supported actions

Triggers

Prerequisites

  • A HubSpot account with access to the CRM objects, lists, workflows, files, or content used by your tools.
  • Permission to authorize the HubSpot OAuth access requested by the integration profile.

Set up the integration

1

Connect HubSpot

In Integrations, select HubSpot > Connect. Create an Integration Profile for HubSpot, complete the OAuth 2.0 setup, and authorize the account your tools will use. Use the scopes and redirect URI shown in the profile setup.
2

Create an action tool

In Tools, select New Tool > Action > HubSpot > Continue. Select the action and auth profile, configure its inputs, and create the tool. Then assign the tool to an agent.

Action reference

The connector catalog lists the required parameter names below. Studio may also show optional inputs for an action; review the selected action’s input panel when configuring a tool.
Add contact to listRequired parameters: listId, email
Adds a contact to a specified workflow in your HubSpot account.Required parameters: workflowId, email
Creates associations between objectsRequired parameters: fromObjectId, fromObjectType, toObjectType, associationType, toObjectIds
Creates a company in Hubspot.Required parameters: None listed in the connector catalog.
Creates a contact in Hubspot.Required parameters: None listed in the connector catalog.
Creates a blog post in you Hubspot COS blog.Required parameters: contentGroupId, authorId, status, slug, title, body, meta, imageUrl
Creates a custom object in Hubspot.Required parameters: customObjectType
Creates a new deal in Hubspot.Required parameters: dealname, pipelineId, pipelineStageId
Creates a line item in Hubspot.Required parameters: productId
Creates a new landing/site page.Required parameters: pageType, pageTitle, internalPageName, templatePath, slug
Creates a new contact or updates an existing contact based on email address.Required parameters: email
Creates a product in Hubspot.Required parameters: None listed in the connector catalog.
Creates a ticket in HubSpot.Required parameters: ticketName, pipelineId, pipelineStageId
Gets a company.Required parameters: companyId
Gets a contact.Required parameters: contactId
Gets a custom object.Required parameters: customObjectType, customObjectId
Gets a deal.Required parameters: dealId
Gets a line item.Required parameters: lineItemId
Gets a product.Required parameters: productId
Gets landing/site page Details.Required parameters: pageType, pageId
Gets a ticket.Required parameters: ticketId
Deletes an existing landing/site page.Required parameters: pageType, pageId
Removes associations between objectsRequired parameters: fromObjectId, fromObjectType, toObjectType, associationType, toObjectIds
Remove a contact from a specific list.Required parameters: listId, email
Removes email subscription.Required parameters: email
Updates a company in Hubspot.Required parameters: companyId
Updates a contact in Hubspot.Required parameters: contactId
Updates a custom object in Hubspot.Required parameters: customObjectType, customObjectId
Updates a deal in HubSpot.Required parameters: dealId
Updates a line item in Hubspot.Required parameters: lineItemId
Updates a product in Hubspot.Required parameters: productId
Updates a ticket in HubSpot.Required parameters: ticketId
Uploads a file to HubSpot File Manager.Required parameters: folderId, fileName, accessLevel, file
Finds associations between objectsRequired parameters: fromObjectId, fromObjectType, toObjectType
Finds a company by searching.Required parameters: firstSearchPropertyName, firstSearchPropertyValue
Finds a contact by searching.Required parameters: firstSearchPropertyName, firstSearchPropertyValue
Finds a custom object by searching.Required parameters: customObjectType, firstSearchPropertyName, firstSearchPropertyValue
Finds a deal by searching.Required parameters: firstSearchPropertyName, firstSearchPropertyValue
Finds a line item by searching.Required parameters: firstSearchPropertyName, firstSearchPropertyValue
Finds a product by searching.Required parameters: firstSearchPropertyName, firstSearchPropertyValue
Finds a ticket by searching.Required parameters: firstSearchPropertyName, firstSearchPropertyValue
Gets an existing owner by email.Required parameters: email
Gets an existing owner by ID.Required parameters: ownerId
Finds and retrieves CRM object pipeline stage details.Required parameters: objectType, pipelineId, stageId
Make a custom API call to a specific endpointRequired parameters: url, method, headers, queryParams

Trigger reference

The trigger inputs and required status below follow the connector catalog. Dropdown choices depend on the HubSpot account and selected object or pipeline.
name, domain, industry, about_us, phone, address, address2, city, state, zip, country, website, type, description, founded_year, hs_createdate, hs_lastmodifieddate, hs_object_id, is_public, timezone, total_money_raised, total_revenue, owneremail, ownername, numberofemployees, annualrevenue, lifecyclestage, createdate, web_technologiesSpecify here a list of additional properties to retrieve | | additionalPropertiesToRetrieve | multi-select dropdown | No | Additional properties to retrieve |
firstname, lastname, email, company, website, mobilephone, phone, fax, address, city, state, zip, salutation, country, jobtitle, hs_createdate, hs_email_domain, hs_object_id, lastmodifieddate, hs_persona, hs_language, lifecyclestage, createdate, numemployees, annualrevenue, industrySpecify here a list of additional properties to retrieve | | additionalPropertiesToRetrieve | multi-select dropdown | No | Additional properties to retrieve |
name, description, price, quantity, amount, discount, tax, createdate, hs_object_id, hs_product_id, hs_images, hs_lastmodifieddate, hs_line_item_currency_code, hs_sku, hs_url, hs_cost_of_goods_sold, hs_discount_percentage, hs_term_in_monthsSpecify here a list of additional properties to retrieve | | additionalPropertiesToRetrieve | multi-select dropdown | No | Additional properties to retrieve |
name, domain, industry, about_us, phone, address, address2, city, state, zip, country, website, type, description, founded_year, hs_createdate, hs_lastmodifieddate, hs_object_id, is_public, timezone, total_money_raised, total_revenue, owneremail, ownername, numberofemployees, annualrevenue, lifecyclestage, createdate, web_technologiesSpecify here a list of additional properties to retrieve | | additionalPropertiesToRetrieve | multi-select dropdown | No | Additional properties to retrieve |
firstname, lastname, email, company, website, mobilephone, phone, fax, address, city, state, zip, salutation, country, jobtitle, hs_createdate, hs_email_domain, hs_object_id, lastmodifieddate, hs_persona, hs_language, lifecyclestage, createdate, numemployees, annualrevenue, industrySpecify here a list of additional properties to retrieve | | additionalPropertiesToRetrieve | multi-select dropdown | No | Additional properties to retrieve |
firstname, lastname, email, company, website, mobilephone, phone, fax, address, city, state, zip, salutation, country, jobtitle, hs_createdate, hs_email_domain, hs_object_id, lastmodifieddate, hs_persona, hs_language, lifecyclestage, createdate, numemployees, annualrevenue, industrySpecify here a list of additional properties to retrieve | | additionalPropertiesToRetrieve | multi-select dropdown | No | Additional properties to retrieve |
hs_object_id, hs_lastmodifieddate, hs_createdateSpecify here a list of additional properties to retrieve | | additionalPropertiesToRetrieve | dynamic property selector | No | Additional Properties to Retrieve |
dealtype, dealname, amount, description, closedate, createdate, num_associated_contacts, hs_forecast_amount, hs_forecast_probability, hs_manual_forecast_category, hs_next_step, hs_object_id, hs_lastmodifieddate, hubspot_owner_id, hubspot_team_idSpecify here a list of additional properties to retrieve | | additionalPropertiesToRetrieve | multi-select dropdown | No | Additional properties to retrieve |
name, description, price, quantity, amount, discount, tax, createdate, hs_object_id, hs_product_id, hs_images, hs_lastmodifieddate, hs_line_item_currency_code, hs_sku, hs_url, hs_cost_of_goods_sold, hs_discount_percentage, hs_term_in_monthsSpecify here a list of additional properties to retrieve | | additionalPropertiesToRetrieve | multi-select dropdown | No | Additional properties to retrieve |
createdate, description, name, price, tax, hs_lastmodifieddateSpecify here a list of additional properties to retrieve | | additionalPropertiesToRetrieve | multi-select dropdown | No | Additional properties to retrieve |
subject, content, source_type, createdate, hs_pipeline, hs_pipeline_stage, hs_resolution, hs_ticket_category, hs_ticket_id, hs_ticket_priority, hs_lastmodifieddate, hubspot_owner_id, hubspot_team_idSpecify here a list of additional properties to retrieve | | additionalPropertiesToRetrieve | multi-select dropdown | No | Additional properties to retrieve |
createdate, description, name, price, tax, hs_lastmodifieddateSpecify here a list of additional properties to retrieve | | additionalPropertiesToRetrieve | multi-select dropdown | No | Additional properties to retrieve |
hs_task_subject, hs_task_type, hs_task_priority, hubspot_owner_id, hs_timestamp, hs_queue_membership_ids, hs_lastmodifieddate,hs_createdateSpecify here a list of additional properties to retrieve | | additionalPropertiesToRetrieve | multi-select dropdown | No | Additional properties to retrieve |
dealtype, dealname, amount, description, closedate, createdate, num_associated_contacts, hs_forecast_amount, hs_forecast_probability, hs_manual_forecast_category, hs_next_step, hs_object_id, hs_lastmodifieddate, hubspot_owner_id, hubspot_team_id, hs_v2_date_entered_current_stageSpecify here a list of additional properties to retrieve | | additionalPropertiesToRetrieve | multi-select dropdown | No | Additional properties to retrieve |

Troubleshoot common issues