Skip to main content
Connect your HubSpot account to Flowella so you can turn HubSpot forms into WhatsApp Flows, send WhatsApp messages from HubSpot workflows and log WhatsApp activity on your contacts. It takes about 5 minutes. Each Flowella organisation connects to one HubSpot account (HubSpot also calls it a portal), and each HubSpot account can be connected to only one Flowella organisation.

​
Before you start

Flowella’s HubSpot settings ask you to check that you:
  • Are a Super Admin in the HubSpot account you connect.
  • Have an active HubSpot subscription.
Some features also depend on your HubSpot plan. Flowella’s workflow actions need HubSpot workflows, which come with Professional and Enterprise plans. The Flowella custom channel needs Sales Hub or Service Hub Professional or Enterprise. See Before you start for the full checklist.

​
Connect HubSpot

1

Open the HubSpot settings

In Flowella, go to Settings → HubSpot. You can also select Connect HubSpot on the Connect HubSpot step of the Setup guide, which opens the same screen.
2

Start the connection

Select Connect HubSpot. Flowella sends you to HubSpot.
3

Choose your HubSpot account

Sign in to HubSpot if asked, then choose the HubSpot account you want to connect.
4

Approve the permissions

HubSpot lists the permissions Flowella is requesting. Select Connect app.
5

Return to Flowella

HubSpot sends you back to Settings → HubSpot, which now shows HubSpot is connected and the next steps.
Finish the HubSpot steps within 10 minutes and in the same browser. Otherwise Flowella shows “Login session expired or cookies were blocked. Try Connect again.” and you start again from Connect HubSpot.

​
Check that it worked

On Settings → HubSpot:
  • The Connection card shows Connected, your Portal (Hub) ID and, where Flowella can read it, your HubSpot account name.
  • View scopes lists the permissions HubSpot granted. HubSpot calls these permissions scopes.
  • The Capabilities card lists the features you can use under Unlocked. See Capabilities.
In the Setup guide, the Connect HubSpot step is ticked.

​
What Flowella adds to HubSpot

Flowella adds the following to your HubSpot account. Disconnecting does not remove any of them.

​
Capabilities

The Capabilities card shows what Flowella can do in your HubSpot account. It reflects the permissions HubSpot granted the last time you connected. Features you can use are under Unlocked. Features under Not available show the permission they need when you point to them. Flowella always asks for the forms and timeline permissions, so Marketing forms and CRM timeline events are unlocked on every connection. HubSpot can leave out the other permissions, for example when your HubSpot subscription doesn’t include the feature.

​
Reconnect to unlock new capabilities

Capabilities only change when you connect again. Reconnect after you upgrade your HubSpot plan, or when Flowella asks you to grant new permissions. There is no separate reconnect button, so you disconnect and then connect.
1

Disconnect

An owner or admin goes to Settings → HubSpot and selects Disconnect HubSpot.
2

Connect again

Select Connect HubSpot, choose the same HubSpot account and select Connect app.
3

Check the capabilities

Check that the feature you need is now under Unlocked.
4

Reconnect the custom channel

If you use the Flowella channel in the HubSpot inbox, connect it again. Disconnecting unlinks it. See Connect the Flowella channel.
Until you connect again, Flowella can’t reach HubSpot: workflow actions can’t send, no activity is logged and WhatsApp messages don’t reach the HubSpot inbox. Reconnect straight away, at a quiet time.

​
Disconnect HubSpot

Only owners and admins can disconnect. Other members see “Only owners and admins can disconnect.” in place of the button.
  1. Go to Settings → HubSpot.
  2. Select Disconnect HubSpot. Flowella disconnects straight away, without asking you to confirm, and shows “HubSpot disconnected.”
After you disconnect:
  • Flowella stops using your HubSpot account. Workflow actions, contact activity and the Flowella channel in the HubSpot inbox stop working.
  • Properties, contacts and timeline events that Flowella already added stay in HubSpot.
  • The Flowella channel stays in your HubSpot inbox settings, but Flowella doesn’t send or receive messages through it. If you connect HubSpot again, connect the channel again too.

​
Install from the HubSpot App Marketplace

If you start from Flowella’s listing in the HubSpot App Marketplace, HubSpot sends you to a Flowella page called Connect Flowella to HubSpot.
  1. Select Sign in to continue.
  2. Sign in to Flowella, or create an account.
  3. Go to Settings → HubSpot and follow Connect HubSpot to finish.

​
Troubleshooting

If the connection fails, Flowella returns you to Settings → HubSpot and shows the reason after “Connection error:”.
Each HubSpot account can be connected to only one Flowella organisation. Ask an owner or admin of the other organisation to disconnect HubSpot there, or choose a different HubSpot account. Contact support if you need to move the connection.
You took longer than 10 minutes in HubSpot, finished in a different browser, or your browser blocked cookies. Allow cookies for Flowella and start again from Connect HubSpot.
You signed in to Flowella as someone else while you were in HubSpot. Sign out, sign in again and retry.
Your Flowella user isn’t a member of the organisation you were connecting. Check that you are in the right organisation, then try again.
HubSpot didn’t complete the connection. Try again. If it keeps failing, contact support.
HubSpot returned an error, shown in brackets after the message. Try again, and contact support with the error if it continues.
Point to the feature to see the permission it needs, then reconnect. If it stays under Not available, your HubSpot subscription may not include the feature.
Ask an owner or admin to select Disconnect HubSpot, then connect again and choose the right account. If the wrong account is linked to another Flowella organisation, disconnect it there first.

Set up Flowella

Follow the Recommended setup guide from start to finish.

Add the custom channel

Bring WhatsApp conversations into the HubSpot conversations inbox.

Workflow actions

Send WhatsApp messages and templates from HubSpot workflows.

Send your first Flow

Go from a HubSpot form to your first Flow submission in HubSpot.
Last modified on October 24, 2026