---
updatedAt: 2026-09-01T08:22:32.000Z
agentTools:
  projectIndex: https://documentation.indigitall.com/llms.txt
---

# HubSpot

The indigitall connector integrates seamlessly with HubSpot, allowing you to add **App Push**, **Web Push**, **SMS**, **Email** and **WhatsApp** actions directly into your Workflows. By expanding your omnichannel capabilities, you can reach your contacts exactly where they are most active.

Follow the onboarding steps below to connect your indigitall and HubSpot accounts and start automating your campaigns.

## Step 1: Connect the App

Go to **Market icon** and click on **App Marketplace**. Feel free to reach out to our support team or your account manager for the **direct link** to set up the integration.

![Marketplace](https://files.readme.io/8563b5c-hubspot1.jpg)

On the searcher, you can looking for *indigitall*.

![searcher](https://files.readme.io/b71eff2-hubspot2.jpg)

An administrator must initiate the installation for the desired business unit or account:

* Review the requested permissions on the connection screen.
* Clicking on **Manage apps** button, you can see what connectors you have integrated. Only it is necessary to click and to choose the account to integrate as the image below shows:

<Image src="https://files.readme.io/af52f33-connecting.jpg" alt="integration" align="center" width="450px" />

### Grant HubSpot Permissions

When you initiate the integration, HubSpot will display a **permission authorization** screen to connect indigitall to your portal.

* Review Requested Permissions: The integration requires specific access to function properly. It will request permission to **Manage and view your CRM data** (allowing the connector to view contact properties and details necessary for targeting your workflows).
* Authorize the Connection: After reviewing the permissions, click the orange **Connect app** button at the bottom left of the window to proceed.

<Image src="https://files.readme.io/b84c9e1a0c512dfe52e6273d475b34722f44b0d8f50dc1ad08abd8de51346825-Connecting_App.jpg" align="center" width="450px" />

### Accept the Unverified App Prompt

Depending on your HubSpot portal's configuration, you may see a warning indicating that the application is unverified.

* To bypass this, type the exact confirmation phrase requested by HubSpot into the text box: **I accept the risk**.
* Click the orange **Connect** button.

<Image src="https://files.readme.io/061d4086bf0a4192333e778f8b695b5044e4b65f7a2b643202e49e06f149989c-unverified_app.jpg" alt="unverified app" align="center" width="450px" />

## Step 2: Log in to indigitall

You will be redirected to the indigitall login page.

* Enter your administrator **Email** and **Password**.
* Select the appropriate **Cloud environment** from the dropdown menu.
* Click **Continue** to finalize the integration.

<Image src="https://files.readme.io/035b0e7080b74d31750cdfd698338c94bf8f97d6a6de85fcc40be17b42e6c2f3-login_1.jpg" align="center" width="450px" />

## Choosing an indigitall Action in HubSpot Workflows

Once the integration setup is complete, all available indigitall messaging capabilities become accessible directly within your HubSpot Workflow builder.

You can see and manage your tools from **Market / Connected apps**:

<Image src="https://files.readme.io/a4c751e-hubspot3.jpg" alt="Connected Apps" align="center" width="450px" />

### Starting a workflow

Go to the left-hand menu and click on the icon with three little circles, then click on **Workflow**. Next, in the top menu, a button will appear to create a workflow from scratch or from a template.

<Image src="https://files.readme.io/1482c62d5a1363f90a213d16288dc7561ebdf1e181fc0e774ceeb5968e47de89-workflows.jpg" alt="workflow" align="center" />

<br />

<Image src="https://files.readme.io/a49c792ec968f2732ec6751f7240089f9cd428d0912e6d0899edfd56274047b2-Proyecto_nuevo_-_2025-04-29T161948.389.jpg" alt="workflow" align="center" />

Then, build your workflow as you normally would. Once you have configured your options, click the **Next** button in the top-right corner. You can add indigitall actions (Push, WhatsApp,Email or SMS) at any step of your workflow sequence.

* The **Choose an action** sidebar panel will appear on the right side of your screen.
* Scroll down to the **Integrated Apps** section and click on indigitall to expand the dropdown menu.
* From this menu, you can select the specific indigitall connector or action you wish to utilize for your automated customer journey:

<Image src="https://files.readme.io/fc9c31dea4d900052b699059d86aa1fb5581eff94e11c71344cb1fb3b1d29bd5-integrated_apps.jpg" alt="connectors" align="center" width="450px" />

## Push Notifications

Click on the Push Notification cell to go to another screen where you can fill in the fields for your previously created push campaign in the console. Complete all the required information and click the Save button in the top-right corner.

<Image src="https://files.readme.io/7db0c09a483c016cd5579299d9b1e462a72ee2197c02d1d445fd78e249aa7890-push_4.jpg" alt="Push Notification" align="center" />

**Campaign ID**:

The campaign ID is the identifier for the push you want to use. Previously you have created and saved it on the indigitall console. Go to **Campaigns>AppPush / WebPush** and copy the ID of the selected campaign to use.

![push campaign](https://files.readme.io/eea33e3-hubspot8.jpg)

* **Device ID Type**:

Now you can choose the type of Device ID between deviceId and externalCode. We recommend the use of **externalCode** for a quick and easy integration method (the integration will be more complicated if you choose deviceId).

The externalCode is the **encrypted identifier** that you have selected to identify each user. Go to the [data synchronization](https://documentation.indigitall.com/docs/data-synchronization) page to learn more.

* **Device field**:

According to our selected trigger, we choose the device field that **the system will take into account to send the push notifications**. For example, as we have chosen the city as a trigger, we choose the field city to know what users are living in London.

* **Campaign param 1...**:

In this field and the following ones, enter the names of the variable fields used in your campaign. Fill in only the ones that are necessary.

Then you can click on **Save** button below.

## WhatsApp messages

Go to the WhatsApp campaign in the console and fill in all the required fields with the correct data copied from that campaign. In the "Multimedia Type" section, select between Image, Video, or Document.

Remember that if you’ve used **variables**, you must use the "Param component 1" field and the following ones to ensure they display correctly.

<Image src="https://files.readme.io/6f275d836e2610abd4a48b33e6b577a77988e941281f97a3a10d40167659ab7b-WhatsApp_4.jpg" alt="WhatsApp" align="center" />

## SMS

Fill out the action details using the configuration panel. Here is a breakdown of the required fields:

* **Campaign Origin**: Choose **how to load the campaigns**. Select Automatic campaign load to pull existing campaigns directly from indigitall, or manually pass the ID.
* **Campaign List**: Select the specific **SMS campaign** you want to trigger from the dropdown menu.
* **How to identify recipients**: Choose the **identifier** used to route the message. You will typically select Phone.
* **Does the phone include a country code?** Specify whether the **phone numbers** in your database already include the country prefix (e.g. Yes, it's included in the same field).
* **Phone field**: Select the specific **HubSpot contact property** that stores the recipient's phone number (e.g., Phone number or Mobile phone number).
* **Campaign Parameters**: If your SMS template in indigitall uses **variables** (like a contact's first name), use these fields to map them. Select the corresponding HubSpot contact properties in order (e.g., map Parameter 1 to First Name, Parameter 2 to Last Name, etc.) so they dynamically populate the message.

Once configured, click **Save** at the top right to apply the action to your workflow.

<Image src="https://files.readme.io/f4aefa075df9668e1e9fcb6fd1ca5fc6845979695e81d562023c1d676b045e1a-SMS_features.jpg" alt="SMS node" align="center" />

## Email

Fill out the action details using the configuration panel:

* **Campaign source**: Choose how to load the campaigns. Select Automatic campaign load to pull existing email campaigns directly from indigitall, or select manual to enter the campaign ID.
* **How to identify recipients**: Choose the identifier used to route the message. You will typically select Email.
* **Campaign Parameters** (1 to 5): If your email template in indigitall uses variables (like a contact's first name), use these fields to map them. Select the corresponding HubSpot contact properties in order (e.g., map Campaign param 1 to First Name, Campaign param 2 to Last Name, etc.) so they dynamically populate the message.

Once configured, click Save at the top right to apply the action to your workflow.

<Image src="https://files.readme.io/3166f2c748c3b122b6091884ed853ebf14814db1965e2316721b7ca05bbe5250-image_82.png" alt="sending email" width="550px" />

## Review and publish

Once your workflow is completed, you can finish it clicking, at the top right area, on the **Review and publish** button.

<Image src="https://files.readme.io/0fa39fb17c8dde308f1b7684535bade9031334a537e099650692871fbeeeeea6-review.jpg" alt="review" align="center" />

<Callout icon="👍" theme="okay">
  ### Note

  You can send **Push notifications**, **WhatsApp messages**, **Email**, and **SMS** at any step of your workflow.
</Callout>

You can visit our [Customer Journey](https://documentation.indigitall.com/docs/customer-journey-definition) area to discover the indigitall journeys using all digital channels from a single console. Don´t miss out!

## Troubleshooting

You might see logs indicating missing parameters, similar to the example shown below.

<Image src="https://files.readme.io/501871ea45ec7ef48e0a148ac5f409fe153dd506723cf5f32b9243a937c1a72a-image_33.jpg" alt="troubleshooting example" align="center" />

First, check the log's severity level to understand the impact:

* **Missing Core Delivery Parameters** (e.g., serverKey, campaignId) ➔ Type: ERROR

  Impact: The delivery process cannot run. Action is required.
* **Missing Individual User Parameters** (e.g., device, phone) ➔ Type: WARNING

  Impact: The specific user will be skipped, but the integration keeps running.

### How to Resolve It

1. **Expand the log entry** in your console to view the complete error payload.
2. **Check** which specific field is missing inside the brackets.
3. **Add the missing field** or mapping in your HubSpot configuration or payload to ensure correct data sync.