HubSpot trigger

The HubSpot trigger is a Connector Event trigger that lets you invoke an integration based on the custom HubSpot events that you've defined in your HubSpot instance.

Before you begin

If you plan to create or configure a new connection for the HubSpot trigger, make sure that you have the following Identity and Access Management (IAM) role on the project:

Connector Admin (roles/connectors.admin)

For information about granting roles, see Manage access.

Grant the following IAM roles to the service account that you want to use for the HubSpot trigger:

Application Integration Invoker (roles/integrations.integrationInvoker)

For information about granting roles to a service account, see Manage access to service accounts.

Supported event types

With webhook subscriptions you can select which events your app would receive. The following subscription types are supported:

deal.creation
deal.propertyChange
deal.deletion
contact.creation
contact.propertyChange
contact.deletion

Add the HubSpot trigger

To add a HubSpot trigger to your integration, follow these steps:

In the Google Cloud console, go to the Application Integration page.
Go to Application Integration
In the navigation menu, click Integrations
The Integrations List page appears listing all the integrations available in the Google Cloud project.
Select an existing integration or click Create integration to create a new one.
If you are creating a new integration:
1. Enter a name and description in the Create Integration pane.
2. Select a region for the integration.
  Note: The Regions dropdown only lists the regions provisioned in your Google Cloud project. To provision a new region, Click Enable Region. See Enable new region for more information.
3. Select a service account for the integration. You can change or update the service account details of an integration any time from the Integration summary pane in the integration toolbar.
  Note: The option to select a service account is displayed only if you have enabled integration governance for the selected region.
4. Click Create.
The newly created integration opens in the integration editor.
In the integration editor navigation bar, click Triggers to view the list of available triggers.
Click and place the HubSpot trigger element in the integration editor.

To configure the HubSpot trigger, you can either use an existing HubSpot connection available in Integration Connectors, or create a new HubSpot connection using the inline connection creation option.

Configure HubSpot trigger using an existing connection

You can configure the HubSpot trigger using an existing HubSpot connection in Integration Connectors. The HubSpot trigger is an connector event trigger, therefore you can only use a HubSpot connection with event subscription enabled to configure the trigger.

For information about how to configure a HubSpot trigger using a new HubSpot connection, see Configure HubSpot trigger using a new connection

To configure a HubSpot trigger using an existing HubSpot connection, follow these steps:

Click the HubSpot trigger element in the integration editor to open the trigger configuration pane.
Click Configure trigger.
Provide the following configuration details in the Connector Event Trigger Editor page:
1. Region: Select the region of your HubSpot connection.
2. Connection: Select the HubSpot connection that you want to use.
  Application Integration only displays those HubSpot connections that are active and have an event subscription enabled.
3. Event type: Select the type of event that you want to use to trigger the integration. For a list of supported event types, see supported event types.
4. Service Account: Select a service account with the required IAM roles for the HubSpot trigger.
Click Done to complete the trigger configuration and close the page.

Configure HubSpot trigger using a new connection

To configure the HubSpot trigger using a new HubSpot connection, follow these steps:

Click the HubSpot trigger element in the integration editor to open the trigger configuration pane.
Click Configure trigger.
Skip the Region field.
Click Connection and select the Create Connection option from the drop-down menu.
Complete the following steps in the Create Connection pane:
1. In the Location step, choose the location for the new HubSpot connection:
  1. Region: Select a region from the drop-down list.
  2. Click Next.
2. In the Connection Details section, complete the following:
  1. Connector: Select HubSpot from the drop down list of available Connectors.
  2. Connector version: Select the Connector version from the drop down list of available versions.
  3. In the Connection Name field, enter a name for the Connection instance.
    Connection names must meet the following criteria:
    - Connection names can use letters, numbers, or hyphens.
    - Letters must be lower-case.
    - Connection names must begin with a letter and end with a letter or number.
    - Connection names cannot exceed 49 characters.
    - For connectors that support event subscription, the connection names cannot begin with the "goog" prefix.
  4. Optionally, enter a Description for the connection instance.
  5. Service Account: Select a service account that has the required roles.
  6. To use the connection for event subscriptions, select Enable event subscription. Selecting this, displays the following options:
    - Enable event subscription with entity and actions: Select this option to use the connection for both event subscription and connector operations (entities and actions).
    - Enable only event subscription: Select this option to use the connection only for event subscription. If you select this option, click Next, and then configure event subscription.
  7. Schema: Specify the HubSpot API version to use. HubSpotV4 is the new API.
  8. BrowsableSchemas: This property restricts the schemas reported to a subset of the available schemas. For example, BrowsableSchemas=SchemaA,SchemaB,SchemaC.
  9. Contacts Properties: Enter the comma separated field names of the Contacts entity that you want to select from the List entity operation. For example, fieldA, fieldB, fieldC
  10. Companies Properties: Enter the comma separated field names of the Companies entity that you want to select from the List entity operation. For example, fieldA, fieldB, fieldC
  11. Deals Properties: Enter the comma separated field names of the Deals entity that you want to select from the