Communication with HubSpot uses its REST API and authentication to it is handled by the OAuth protocol.
To connect Eventmaker to your HubSpot instance, you must have a user account with an Administrator profile preferably; a legacy application must be created on your instance and this will provide you with a Client ID and a Client Secret which are essential to establish the connection.
This article will explain how to create the legacy application and how to connect Eventmaker to HubSpot using it.
Step 1
Go to the Settings area of your HubSpot instance, then from the navigation open the Integrations menu and click on Legacy apps (you can also access it from the Development menu). Finally click on Create a legacy app and choose the Public option.
Step 2
Fill in the basic information for your application: we recommend naming the application "Eventmaker" to identify it more easily; you can also assign it a logo and a description. Now click on the Authentication tab to proceed.
Step 3
As you can see, the Client ID and Client Secret are not yet available. You must first finish the configuration.
Scroll to the Redirect URL section and add https://app.eventmaker.io/oauth/hubspot/callback as the redirect URL.
Step 4
In the following Domains section, you will need to indicate what Eventmaker will be allowed to do on the CRM on your behalf through this application.
Click on Add a new application field and select the following domains, marking them as required:
crm.lists.read
crm.lists.write
crm.objects.contacts.read
crm.objects.contacts.write
crm.objects.companies.read
crm.objects.companies.write
crm.objects.deals.read
crm.objects.deals.write
crm.objects.marketing_events.read
crm.objects.marketing_events.write
oauth
🚨 Warning: it is very important to select only the domains from the list above (no more, no less), otherwise the connection will fail.
You do not need to touch the rest of the form.
Finally, click on Create an application.
Note that now that the application is created, you have access to the Client ID and Client Secret which you will need to copy into Eventmaker.
🚨 Warning: these are sensitive details, do not share them!
Step 5
Back in Eventmaker, go to the third-party tools marketplace via the Integrations tab, then click on HubSpot.
It is finally time to connect Eventmaker to your HubSpot instance. To do this, enter the Client ID and Client Secret retrieved earlier and click the Connect to HubSpot button.
A HubSpot login window will open, where you must use the administrator user account to sign in and then accept the permissions. This will allow Eventmaker to retrieve, via HubSpot's API, the other information necessary for authentication, notably your access token. Finally you will be redirected back to the initial form which indicates whether the authentication is valid.
You can then continue configuring your HubSpot integration.