integration-service
2024.10
true
UiPath logo, featuring letters U and I in white
Integration Service for Automation Suite User Guide
Automation CloudAutomation Cloud Public SectorAutomation Suite
Last updated Nov 11, 2024

HubSpot Marketing authentication

Prerequisites

Depending on the authentication type you select, you need one of the following credentials:

  • Bring your own OAuth 2.0 app: client ID and client secret.
  • Private app access token: token.
To connect with HubSpot, you need to have a developer account.

For creating a private OAuth2 app, follow the steps mentioned in the HubSpot documentation i.e. Working with OAuth. To learn more about private applications for HubSpot, see Private apps in the HubSpot documentation.

Add the HubSpot Marketing connection

To create a connection to your HubSpot Marketing instance, you need to perform the following steps:

  1. Select Integration Service from Automation Suite.

  2. From the Connectors list, select HubSpot Marketing. You can also use the search bar to narrow down the connector.

  3. Select the Connect to HubSpot Marketing button.
  4. Select an authentication type and enter the required credentials.

  5. Select Connect.

  6. Your connection has been added.
Note:

The following message is displayed at connection time: You're connecting an unverified app. This app's details haven't been reviewed or verified by HubSpot. Make sure you trust the developer before connecting it to your account.

The UiPath app is currently being reviewed by HubSpot for approval. While the app is in review, it is ready to be used. After approval, the warning message will no longer be displayed, without any changes on the connector side.

Scopes and permissions

You can use the connection to enable the HubspotMarketing activities in UiPath Studio to build automations for list, contact, company management. The various permission-based use cases that can be achieved are as follows:

Scope/PermissionUsecaseActivity/Event
crm.objects.contacts.readAs a user I want to sync my CRM contacts to Hubspot Marketing and keep them engaged with marketing emails.

Get Contact

List All Records → Contacts

List all Records → Contact Associations

crm.objects.contacts.write

Create Contact

Update Contact

crm.objects.companies.readAs a user I want to sync my CRM companies to Hubspot Marketing and keep them engaged with marketing emails.

Get Company

List All Records → Companies

List all Records → Company Associations

crm.objects.companies.write

Create Comapny

Update Company

crm.lists.readAs a user I want to assign my contacts to some contact list in Hubspot Marketing. I have tagged/grouped my CRM contacts based on their previous purchase and for my upcoming marketing campaigns I’d need to sync them to some Contact list.

Get List

List All Records → Lists

crm.lists.write

Create List

Update List

Add Contact to List

filesUpload file / attachments related to the customer such as sales order or engagement report etc.

Upload File

Update File

Insert Record → Folders

List All Records → Folders

crm.objects.deals.writeSyncing of deals/opportunities between CRM and marketing helps users track the progress on those deals

Insert Record → Deals

Update Record → Deals

crm.objects.deals.read

List All Records → Deals

List all Records → Deal Associations

crm.schemas.contacts.read

crm.schemas.companies.read

crm.schemas.deals.read

Retrieve a single or all the custom properties of the deal/contact/company in order to add/update value to the same

List All Records → Properties

Get Record → Properties

crm.schemas.deals.write

crm.schemas.contacts.write

crm.schemas.companies.write

Create/Update custom properties of deal/contact/company

Insert Record → Properties

Update Record → Properties

automationRetrieve all the active automations/workflows in Hubspot

List all Records → Workflows

Get Record → Workflows

formsRetrieve, create or update forms in Hubspot

List all Records → Forms

Insert Record → Forms

Update Record → Forms

  • Prerequisites
  • Add the HubSpot Marketing connection
  • Scopes and permissions

Was this page helpful?

Get The Help You Need
Learning RPA - Automation Courses
UiPath Community Forum
Uipath Logo White
Trust and Security
© 2005-2024 UiPath. All rights reserved.