---
title: Hubspot contact list
description: Add or remove contacts from HubSpot lists directly within your workflow.
category: Application
tags: [hubspot, contact, list, crm, automation]
---

# Hubspot contact list

## 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.

## Input

| Input Type | Required                                                         |
| ---------- | ---------------------------------------------------------------- | ------ |
| **Data**   | Required for `Create Many` and optional for `Update` operations. | 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: <ul><li>Add</li><li>Remove</li></ul> |
| **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`.          |

## Sample Input

| Operation  | Required Fields                               | Example Input                                                                                                          |
| ---------- | --------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| **Add**    | `Add Contact Id`, `Add Contact List Id`       | <table><tr><td>Add Contact Id</td><td>12345</td></tr><tr><td>Add Contact List Id</td><td>56789</td></tr></table>       |
| **Remove** | `Remove Contact Id`, `Remove Contact List Id` | <table><tr><td>Remove Contact Id</td><td>12345</td></tr><tr><td>Remove Contact List Id</td><td>56789</td></tr></table> |

## Sample Configuration

| Field              | Value   |
| ------------------ | ------- |
| `operation`        | `Add`   |
| `addContactId`     | `12345` |
| `addContactListId` | `56789` |

## Sample Output

| Message                                         |
| ----------------------------------------------- |
| Contact 12345 added to list 56789 successfully. |