Appearance

HubSpot ​

Install HubSpot integration ​

The HubSpot integration can be found here. Please install it in your environments before proceeding with the steps below.

Connecting a HubSpot account ​

WARNING

  • Administrator role is required to use this API
  • Role information is only available in Enterprise plan

  1. Click on Connect AccountClick connect account

  2. Type in a value for the Tenant ID. This can be any ID of your choosing. And then click on Get connection linkGet connection link

  3. A new link will be generated. Clicking on the link will open a new tab with the list of integrations. You can share this link with your customers too, and they will be able to connect their HubSpot account. Share connection link

  4. Select HubSpot Select HubSpot

  5. You'll now be asked to log in to your HubSpot account and allow access to Truto. Go through the steps.

  6. Voila! You should now see a connection successful message. You can now close this tab.

  7. Go to your Truto account, and you should see the new HubSpot integration under Integrated Accounts. Click on the Account ID to view the details and initiate API calls.

Setting up Unified Webhooks for HubSpot ​

INFO

Needs to be done only once per environment

Setting up Webhooks in Truto ​

  1. Login to https://app.truto.one/ and navigate to Webhooks tab
  2. Click on the Create Webhook button and modal shows up.
  3. Enter your endpoint URL in the Endpoint input to which you would like to get the webhook events posted.
  4. Set the webhook to Active to start listening to the events.
  5. Choose record:created, record:updated, record:deleted to only get the events related to the Unified Webhooks or select “all” to receive all the events.
  6. Click on Create Webhook to save the webhook. Truto Webhooks Modal

Connecting Webhooks from HubSpot to Truto ​

  1. Go to your HubSpot Developer account and navigate to the OAuth app for which you would like to setup Unified Webhooks.
  2. Click on the Webhooks tab under the Features section.
  3. Enter the target URL in the following format - api.truto.one/environment-integration-webhook/<your_environment_integration_id>
    1. You can find the environment_integration_id from the Truto UI by navigating to the following URL and select the environment for which you are setting up webhooks - https://app.truto.one/integrations/installed?search=hubspot
    2. You can also refer to the following GIF to find the environment_integration_id - Find environment_integration_id
  4. Once the Target URL is added, Click on Create Subscription
  5. Select the object types for which you would like to receive webhooks. Currently, Contact, Company, Deal are supported.
  6. Select the events for which you would like to receive webhooks.
  7. If you see below shown warning, click on Add these required scopes and select the scopes and Click on Update. Add required scopes
  8. Once the required scopes are added, come back to Webhook section and select object types and events again and click on Subscribe.
  9. You should now see the webhook subscription created successfully.
  10. Select all the Event subscriptions and Click on ActivateActivate HubSpot Event Subscriptions

Voila!! You should now start receiving the Unified Webhook events to your endpoint URL .