Sequence Workflow Actions for HubSpot

At a glance

Adds two workflow actions to HubSpot. Pick a sender and a sequence, and enroll contacts at scale, or unenroll them when the workflow says so.

Works without Sales Hub Enterprise
Sender mailbox picker (uses your existing user accounts)
Unenrollment via workflow (a HubSpot first)
OAuth, scoped permissions, no third-party services

Action fields

Enroll Contact in Sequence

Sequence (required) — Dropdown of all sequences in your portal. Populated when a sender is selected.

Sender (required) — Dropdown of HubSpot users/owners. The enrollment is made on behalf of this user using their mailbox and sender identity.

Outputs: success, enrollment_id, error_message.

Unenroll Contact from Sequence

No inputs required. The action identifies the contact's active sequence automatically and triggers unenrollment.

Outputs: success, was_enrolled, error_message.

Note: During unenrollment a temporary future meeting is briefly logged on the contact and then automatically deleted (typically within 10 seconds). This is expected behaviour, it is the mechanism HubSpot uses to trigger unenrollment.

Output Fields

After each action runs, these outputs are available in later workflow steps:

success: true if the action completed without error, otherwise false.
enrollment_id (Enroll only): The HubSpot enrollment ID created for this contact.
was_enrolled (Unenroll only): true if the contact was enrolled in a sequence and has now been unenrolled.
error_message: Error detail when the action fails. Empty on success.

Example: Branch on success

Add an If/then branch after the action and check whether success is equal to true.

Example: Track enrollment ID

Use a Set property value action to save enrollment_id to a HubSpot contact property for later reference or reporting.

Install the app

The app is installed via HubSpot's standard OAuth flow. No developer credentials or API keys on your side are required.

Go to the HubSpot App Marketplace and search for Sequence Workflow Actions.
Click Install on the listing page.
You will be redirected to the King Henry authorisation page.
Review the requested permissions and click Connect app.
HubSpot will ask you to approve the scopes the app requires. Click Connect app on the HubSpot scope approval screen to grant access.
After approving, you are redirected back to HubSpot. The app will appear in Settings → Integrations → Connected Apps.

Connect your HubSpot account

The OAuth authorisation step above connects your HubSpot account. No additional connection steps are needed after install — the app is immediately ready for use in contact-based workflows.

The app requests the minimum scopes needed: automation.sequences.read, automation.sequences.enrollments.write, crm.objects.contacts.read, crm.objects.contacts.write, and crm.objects.owners.read.

One installation covers your whole portal. You only need to install and authorise the app once. All users in your HubSpot portal can immediately add Enroll in Sequence and Unenroll from Sequence actions to their workflows — no per-user setup is required.

Add the action to a workflow

Once installed, both sequence actions are available in every contact-based workflow.

Go to Automation → Workflows and open an existing contact-based workflow, or create a new one.
Click the + button to add a new action at the desired position.
In the action panel, type Enroll in Sequence or Unenroll from Sequence in the search box — or scroll to the Connected apps section.
Click the action you want to open the configuration panel.

Configure the action fields

Enroll Contact in Sequence

Sequence (required) — A dropdown of all sequences in your portal. Populate the Sender field first — the sequence list filters to sequences the sender has access to.

Sender (required) — A dropdown of HubSpot users/owners. The enrollment is created on behalf of this user. They must have access to the selected sequence and a connected sending mailbox.

Unenroll Contact from Sequence

No configuration fields are required. The action automatically identifies the contact's active sequence enrollment and triggers unenrollment.

How unenrollment works: HubSpot does not expose a direct unenroll API. The action logs a temporary future meeting on the contact — HubSpot natively unenrolls contacts when a meeting is booked — waits for the hs_sequences_is_enrolled property to flip false, then deletes the temporary meeting. The whole process completes within a single workflow action step (~10 seconds).

Use output fields in subsequent steps

After each action runs, output fields are available to reference in downstream workflow steps such as If/then branches or Set property value actions.

Output field	Type	Description
`success`	Boolean	`true` if the action completed without error.
`enrollment_id`	String	Enroll action only. The HubSpot enrollment ID created for this contact.
`was_enrolled`	Boolean	Unenroll action only. `true` if the contact was enrolled in a sequence and has now been unenrolled.
`error_message`	String	A description of the error if the action failed. Empty on success.

Example: Branch on success or failure

Add an If/then branch immediately after the action. Set the condition to Enroll Contact in Sequence, success is equal to true to route contacts differently depending on whether enrollment succeeded.

Example: Save the enrollment ID to a property

Add a Set property value action after enrollment. Use the enrollment_id output token as the value to store the enrollment ID in a HubSpot contact property.

Disconnect the app

Disconnecting revokes the OAuth authorisation token between your HubSpot portal and King Henry. After disconnecting, any workflow that runs a Sequence Workflow Actions step will fail because the action can no longer be executed.

Active workflows will stop working. Before disconnecting, pause or update any live workflows that contain an Enroll or Unenroll step. Disconnecting does not delete the workflow steps — they remain in your workflow editor and can be reactivated if you reinstall the app.

To disconnect:

Go to Settings → Integrations → Connected Apps.
Find Sequence Workflow Actions in the list.
Click Actions → Disconnect (or Uninstall, depending on your HubSpot version).
Confirm the disconnection in the dialog that appears.

What happens to your data: Disconnecting does not delete any HubSpot properties, workflow configurations, or enrollment history. No data stored in HubSpot is removed. King Henry does not retain any of your HubSpot data after disconnection.

Uninstall the app

Uninstalling fully removes the app from your HubSpot portal, including the OAuth connection and the registered workflow action types.

To uninstall:

Go to Settings → Integrations → Connected Apps.
Find Sequence Workflow Actions in the list.
Click Actions → Uninstall.
Read the confirmation message and click Uninstall to confirm.

Workflows using these actions will stop executing those steps. Any workflow containing an Enroll or Unenroll step will continue to run, but those steps will be skipped or marked as failed after uninstallation. To restore full functionality, reinstall the app and reconnect via OAuth.

What happens to your data after uninstall:

No HubSpot contacts, companies, deals, or other records are deleted.
No HubSpot properties are deleted.
Existing workflow steps that referenced the sequence actions remain in the workflow editor but are marked as inactive.
Workflow enrollment history is preserved and still visible in HubSpot.
King Henry does not store any of your HubSpot data, so there is nothing on King Henry's side to delete.

You can reinstall the app at any time from the HubSpot App Marketplace. After reinstalling, existing workflow steps that referenced the actions will become active again without reconfiguration.

The action shows an error in workflow history

Check the error_message output field in the workflow enrollment history for the failing contact.
Confirm the sender has access to the selected sequence (typically the user who created it or an admin).
Check that the contact is not already enrolled in another sequence — HubSpot only allows one active enrollment at a time.
Confirm your portal is on Sales Hub Professional, Service Hub Professional or higher.