> This page is for version Scripted.
> For other versions, use one of these documentation indexes:
> - Generative (default): https://developers.ada.cx/generative/llms.txt
> - Scripted: https://developers.ada.cx/scripted/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developers.ada.cx/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.ada.cx/_mcp/server.

# Manage contacts using the HubSpot app

## Overview\[#UUID-386b1727-3ae8-e2f0-51b6-e1072bbdb2b1_id_1500005646862_id_h_01F2H51QQ9J1QX4JZJPP5DCT90]

With the HubSpot Action Block, you can perform the following actions in
HubSpot, all from within your bot:

* Create or update a contact

* Lookup a contact by email

* Lookup a contact by cookie—the cookie will need to be passed to Ada
  through metaFields

> **Note**
>
> This feature may not be included with your organization's subscription
> package. For more information, see Ada's
> [Pricing](https://www.ada.cx/pricing) page, or contact your Ada team.

Before using the Hubspot Action block, you need to configure the
integration with HubSpot in the Ada dashboard.

## Configure the HubSpot Action Block\[#UUID-386b1727-3ae8-e2f0-51b6-e1072bbdb2b1_id_1500005646862_id_h_01F2H52CFR5ZWQQ2KY8M6S2PVN]

To configure:

1. Navigate to **Settings** > **Integrations**.

2. Under **App Integrations**, select **HubSpot**.

3. Paste your HubSpot API key (found in your [HubSpot environment](https://knowledge.hubspot.com/integrations/how-do-i-get-my-hubspot-api-key))
   into the API Key field and click **Save**.

## Use the HubSpot Action Block\[#UUID-386b1727-3ae8-e2f0-51b6-e1072bbdb2b1_id_1500005646862_id_h_01F2H52TK65HTZFAVARSYRSTRN]

To use the HubSpot Action block:

1. Drag the block into the appropriate Answer.

2. Select the action you want the block to perform in the **Select
   Action** dropdown.

3. Identify the variable in Ada that should be passed to HubSpot in the
   mandatory input field—in this example, **Email** is mandatory.

4. In the **Select Optional Inputs** dropdown, select any other field
   from HubSpot you want to map Ada variables to. In this example, we
   added **City** as an optional input.

5. If you want to save the Contact ID in Ada for future use in an
   Answer flow, under **Save Response as Variables** select **Contact
   ID**, and then the appropriate variable to save the information in.

6. Select a Fallback Answer in the event that the request fails.

---

Have any questions? Contact your Ada team, or email us at [](<mailto:help@ada.support%20%E2%80%9CHelp Docs inquiry%E2%80%9D>).