Description
The HubSpot Contact List entity allows you to manage the relationship between contacts and static contact lists within your HubSpot CRM. This is especially useful for organizing contacts into targeted lists for campaigns, workflows, or segmentation.
The HubSpot Contact List activity enables workflows to programmatically add a contact to a list or remove them from a list, based on the configured operation and IDs provided.
Use this activity to:
- Add – Add a contact to a specific HubSpot static list.
- Remove – Remove a contact from a static list.
Use Case: After identifying a set of leads based on user actions or marketing segments, you can use this activity to add or remove them from relevant HubSpot contact lists for targeted email campaigns.
| Field Name | Description | Required for Operation |
|---|
| Add Contact Id | ID of the contact to add to a list | Add |
| Add Contact List Id | ID of the list to which the contact will be added | Add |
| Remove Contact Id | ID of the contact to remove from a list | Remove |
| Remove Contact List Id | ID of the list from which the contact will be removed | Remove |
Output
| Output Type | Format | Description |
|---|
| Data | JSON | Operation success response and status |
Configuration Fields
| Field Name | Description |
|---|
| Connection | Select a HubSpot connection (OAuth). Required for authentication. |
| Operation | Choose from the supported operations: |
| Add Contact Id | ID of the contact to add to a list. Required for Add. |
| Add Contact List Id | ID of the list to add the contact to. Required for Add. |
| Remove Contact Id | ID of the contact to remove from a list. Required for Remove. |
| Remove Contact List Id | ID of the list to remove the contact from. Required for Remove. |
| Operation | Required Fields | Example Input |
|---|
| Add | Add Contact Id, Add Contact List Id | | Add Contact Id | 12345 | | Add Contact List Id | 56789 |
|
| Remove | Remove Contact Id, Remove Contact List Id | | Remove Contact Id | 12345 | | Remove Contact List Id | 56789 |
|
Sample Configuration
| Field | Value |
|---|
operation | Add |
addContactId | 12345 |
addContactListId | 56789 |
Sample Output
| Message |
|---|
| Contact 12345 added to list 56789 successfully. |
