HubSpot
Automatically add or remove contacts from HubSpot lists and update contact properties using event-driven rules.
The HubSpot integration allows Meshes to automatically manage HubSpot contacts based on events that occur in your workspace.
Once connected, HubSpot becomes available as an action target in your rules. When a matching event is triggered, Meshes can add or remove contacts from HubSpot lists and update contact property values.
Supported Actions
The HubSpot integration supports the following actions:
- Add Contact to List Adds a contact to a specified HubSpot list.
- Remove Contact from List Removes a contact from a specified HubSpot list.
- Update Contact Properties Updates one or more properties on a HubSpot contact.
Step 1: Create a HubSpot Connection
To get started, you must first create a HubSpot connection.

- Navigate to your workspace and open Connections
- Click New Connection
- Enter a name for the connection (for example,
HubSpot) - Select HubSpot as the connection type
- Click Connect to HubSpot
You will be redirected to HubSpot to authorize the Meshes app. After authorization is complete, HubSpot will redirect you back to Meshes and the connection will be available for use in rules.
Step 2: Create a Rule
Once the HubSpot connection is created, you can define rules that determine how contacts are managed in HubSpot.

- Open the Rules tab for your workspace
- Click New Rule
- Select the Event Type that will trigger the rule (for example,
Contact Created) - Choose the Resource Type that applies to the event
- Select your HubSpot connection
- Choose an action:
- Add to List
- Remove from List
- Update Property
- Select the target list or properties for the action
- Click Create Rule
Once saved, the rule becomes active immediately.
Step 3: Send a Test Event

Meshes allows you to test rules or run one-off integrations using the Send Test Event feature.
- Open the rule you want to test
- Click Send Test Event
- Provide a JSON payload that includes a valid
emailfield - Click Send Event
Example payload:
{
"email": "test@example.com",
"first_name": "Test",
"last_name": "User"
}
Step 4: Review Event Results
After an event is processed, you can view detailed execution results.
- Navigate to the Events tab
- Select the event you want to review
- View the event status and any rules that were processed
The event details page shows:
- Event status (Completed or Failed)
- Which rules were triggered
- The HubSpot action performed
- Execution attempts and timestamps
This makes it easy to verify successful updates or troubleshoot issues.
Notes
- HubSpot lists and properties are loaded dynamically based on the connected HubSpot account.
- Contacts are identified primarily by email address.
- Property updates only affect the fields configured in the rule.
- Properties that are allowed are selectable / enumerable field types defined by the user account.