Building a HubSpot integration
This tutorial will give an example of how to create a HubSpot integration that syncs contacts from your app to your Linked account’s HubSpot account.
Pre-requisites
- HubSpot App is enabled in Cobalt.
- HubSpot OAuth app credentials added to Cobalt. Refer here.
- Trigger created in Cobalt. Refer here.
- Linked Account available. Refer here.
Building a Workflow
1. Create Workflow in app
- Go to your
Apps catalog
in Cobalt > Search forHubSpot
>Workflows
>Add Workflow
> ChooseManually
> Give it a name and click onAdd Workflow
.
2. Adding the Trigger
To add a trigger for a Workflow in Cobalt, you need to select details about the Trigger like the Type and which trigger to be implemented.
To add a Trigger, follow these steps:
- Click on the Start node to add a trigger.
- In the right side, select the Type and the Trigger and click on the
Add Trigger
button.
For this Workflow, we have created an Event Contact Create
which contains the payload like the first name, last name, email etc. about the event sent by you to HubSpot.
3. Adding the HubSpot Action
- From
Actions
, add a HubSpot node to the workflow.
- Click on the node and select an Action from the
Choose an Action
dropdown menu and click onSave
.
Before clicking on Save
, make sure that you have entered data for all the mandatory fields whichever required.
- Connect the two nodes by clicking on
+
button on theStart
node and dragging the arrow to the HubSpot node.
4. Publishing the Workflow
- To publish the workflow, click on the
Publish
button in the top, Select Environments of the Workflow and click onPublish
.
Enabling the Workflow
To enable a workflow, end user or a Linked Account needs to Toggle On the Workflow after connecting with the application.
- Navigate to the Linked Account in which the Workflow needs to be enabled by getting its’ Hosted URL.
- Go to the Hosted URL and select HubSpot from
Manage your Integrations
list. - Click on the
Connect
button, review the permissions and allow them for a successful connection. - After a successful connection, you can see the
Configure
section in the HubSpot Application page. - Enable the Workflow Sync Contacts by turning the toggle On and click on
Save
.
Fire an App Event
Lastly, we’ll fire an App Event whenever a contact is created in your app by using the Workflow.
- Navigate to
Try API
in Cobalt. - Choose the Linked Account created to test the workflow, select the Event and
HubSpot
as the Application. - Click on the
Fire Event
button in the top right.
- You can check the status of the event by navigating to
Logs
>Events
in Cobalt.
Congratulations! We have successfully built a HubSpot integration that syncs new contacts from your app to the Linked Account’s HubSpot.