Introduction
Docebo Connect is a Docebo module acting as a connector between your platform and third-party SaaS systems, helping you to integrate your platform with more than 400 third-party external systems, reducing the integration effort.
Docebo Connect offers a large catalog of connectors for the most popular SaaS systems, to manage automated workflows (called recipes) shared among systems in order to exchange and share data on the basis of triggers.
Please note that Docebo Connect takes advantage of the APIs and business logic already existing in the integrating systems and does not create new ones. In addition, Docebo Connect does not manage SSO flows with Identity Providers (such as SAML, OpenID Connect, etc), JavaScript integrations (such as Google Analytics or Google Tag Manager) or iframe integrations (such as Docebo OEM or Salesforce Canvas).
The integration for HubSpot allows you to synchronize Docebo Users to and import users from HubSpot.
For more information on the definition of terms and concepts used throughout this article, please read Docebo Connect Glossary of Terms.
Activating Docebo Connect
Docebo Connect is a paid product. To activate Docebo Connect on your platform or sandbox, please reach out to your Docebo Account Manager.
Before You Start
All the recipes for this integration can be found in the project's folder. This folder should be considered a “special folder” as all the recipes contained within are subject to automatic updates. As such, any customizations you make to recipes located within the folder can be overwritten by Docebo. In order to prevent such an occurrence, it is strongly advised to create a new project folder for any recipes you wish to use in production and copy or clone the recipes from the project's folder inside.
A complete list of recipes used by this integration, including which sub-recipe they call, can be found in the chapter Recipe Descriptions.
Configuring the Integration
Prior to using Docebo Connect for HubSpot, you will need to configure the integration, following are the steps necessary to successfully set up the lookup tables and recipes.
Configuring the Lookup Table
Docebo Connect for HubSpot uses the standard integration-settings table where the settings for the integration are stored.
Please Note: All boolean values must be stated as either true or false in lower-case.
Click on the gear icon and locate Docebo Connect, then click on Manage. Next, click on the Lookup Table tab and then click on the integration-settings table.
Please make sure that the table in the platform matches the table presented here, if any of the following rows are missing, please add them by typing the values in the relevant text boxes and then pressing the check mark icon to save the row.
Add the following rows if they do not already exist:
| Integration | Key | Value |
|---|---|---|
HUBSPOT |
NOTIFICATION_MAIL_ID |
The email address of the user to receive notification if any error occurs in a job. |
Once all the values are added the lookup table should look similar to this example:
Configuring the Connector
Navigate to your project folder and press the down arrow on the Create button in the top right corner of the window. In the resulting drop-down menu, select Connection.
In the resulting New connection screen, type HubSpot into the search text box and in the search results field, select the HubSpot connector.
Next, in the Connect to HubSpot window, give your connection a meaningful name and in the Location drop-down menu select the top level where you have stored your HubSpot recipe clones. Then, press the Connect button.
Recipe Descriptions
New/updated user records in HubSpot
This recipe must be started in Docebo Connect in order for this integration to function properly. For more information on starting recipes, please see Docebo Connect Usage: Common Recipe Actions.
The recipe is responsible for real-time synchronization, which receives user creation and update events from HubSpot for every 5 minutes.
- Trigger
- Runs continuously
- Calls to other recipes
Bulk User Sync - Hubspot to Docebo
This recipe should be run manually only when a full migration of users from HubSpot to Docebo is performed. It should not be started. If you start this recipe then a full migration is performed every five minutes. In order to run this recipe, open it in the recipe editor and press the Test recipe button, doing so will run the migration once and ignore the five minute time trigger.
The recipe is responsible for performing batch synchronizations.
- Trigger
- Runs automatically every five minutes
- Calls to other recipes
Retrieve contacts from Hubspot
This recipe is responsible for retrieving the contact (user) details from HubSpot.
- Trigger
- Called by another recipe
- Calls to other recipes
Recursion to retrieve contacts
This recipe performs recursive calls to retrieve contact (user) details from HubSpot.
- Trigger
- Called by another recipe
- Calls to other recipes
Processing Hubspot user details
The recipe is responsible for segregating contact (user) details with and without email.
- Trigger
- Called by another recipe
- Calls to other recipes
Create / Update users from Hubspot to Docebo LMS
This recipe is responsible for creating users if not present or updating users if present in the Docebo Learn Platform through batch call, based on the details provided as input from the Processing HubSpot user details sub recipe.
- Trigger
- Called by another recipe
- Calls to other recipes