> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# HubSpot Webhook Configuration

> To successfully configure the webhook and send the event on action.

<Warning>
  This guide assumes that you have administrative privileges for your HubSpot account.
</Warning>

## ✅ Prerequisites

Make sure you have the following before you start:

* A [HubSpot Developer Account](https://developers.hubspot.com)

## Get Credentials

<Steps>
  <Step title="Log in to HubSpot Developer Account">
    Log in to your HubSpot Developer Account at [https://app.hubspot.com/login](https://app.hubspot.com/login)

    <Frame>
      <img src="https://mintcdn.com/stackone-60/POgdaSWWHjUFRYuz/images/hubspot/image10.png?fit=max&auto=format&n=POgdaSWWHjUFRYuz&q=85&s=77435b74ab7fb98ce9c8fe51d0a04138" alt="Log In" width="1273" height="770" data-path="images/hubspot/image10.png" />
    </Frame>
  </Step>

  <Step title="HubSpot OAuth App">
    * Select **Apps** from the navigation panel.
    * Click **Create App** to create a new app or select an existing app from the list.

    <Frame>
      <img src="https://mintcdn.com/stackone-60/EZ7nWzE-JJzhmP-C/images/hubspot/image3.png?fit=max&auto=format&n=EZ7nWzE-JJzhmP-C&q=85&s=9d9e370da2b0bc0ce1aa4d1861434a9e" alt="App List" width="2808" height="1428" data-path="images/hubspot/image3.png" />
    </Frame>
  </Step>

  <Step title="Get the Developer API Key">
    * Select **Keys** from the left sidebar.
    * Click **Show** to view your existing key or **Generate New Key** to create one.
    * Copy the key and store it securely.

    <Note>
      Developer API key is required to subscribe `create` and `delete` events for `Contacts` and `Accounts`
    </Note>

    <Frame>
      <img src="https://mintcdn.com/stackone-60/EZ7nWzE-JJzhmP-C/images/hubspot/image9.png?fit=max&auto=format&n=EZ7nWzE-JJzhmP-C&q=85&s=e3998f5d5d9f5dcdd6f6522719f74a5e" alt="API Key" width="2866" height="1670" data-path="images/hubspot/image9.png" />
    </Frame>
  </Step>
</Steps>

## Configure Webhooks

<Steps>
  <Step title="Navigate to Webhooks">
    In your app dashboard, navigate to **Apps>Webhooks**.

    <Frame>
      <img src="https://mintcdn.com/stackone-60/EZ7nWzE-JJzhmP-C/images/hubspot/image4.png?fit=max&auto=format&n=EZ7nWzE-JJzhmP-C&q=85&s=070dd40510f81ceb04fde81ee0b1119d" alt="Webhook Page" width="2816" height="1452" data-path="images/hubspot/image4.png" />
    </Frame>
  </Step>

  <Step title="Set the Webhook URL">
    * Add your `External Trigger URL` in the Target URL field.
      <Note>This step is only required when configuring update events for Contacts and Accounts.
      For all other events (such as create and delete), webhook subscriptions are handled automatically via the Webhook Subscription API, and no manual configuration of the Target URL is needed. </Note>

    <Frame>
      <img src="https://mintcdn.com/stackone-60/EZ7nWzE-JJzhmP-C/images/hubspot/image5.png?fit=max&auto=format&n=EZ7nWzE-JJzhmP-C&q=85&s=78fc0d8777ed0005c8d6b17492eaaec3" alt="Target URL" width="2398" height="1496" data-path="images/hubspot/image5.png" />
    </Frame>

    * Click **Save** to save the changes.

    <Frame>
      <img src="https://mintcdn.com/stackone-60/EZ7nWzE-JJzhmP-C/images/hubspot/image8.png?fit=max&auto=format&n=EZ7nWzE-JJzhmP-C&q=85&s=179915f945d96680c7ad53c0c08d5c5c" alt="Save changes" width="2894" height="1736" data-path="images/hubspot/image8.png" />
    </Frame>
  </Step>

  <Step title="Subscribe to Events">
    * Click **Create Subscription**
    * Select the object and event you want to subscribe to.
      * `contact.propertyChange`
      * `company.propertyChange`
    * Select the field you want to trigger the `propertyChange` event on.
    * Save subscription by clicking **Subscribe** button.

    <Note>
      This step is only required when configuring *update* events for **contacts** and **accounts**.
    </Note>

    <Frame>
      <img src="https://mintcdn.com/stackone-60/EZ7nWzE-JJzhmP-C/images/hubspot/image6.png?fit=max&auto=format&n=EZ7nWzE-JJzhmP-C&q=85&s=a2026e9cfa96f66c206c101308af8354" alt="Subscribe Event" width="2772" height="1656" data-path="images/hubspot/image6.png" />
    </Frame>

    * Activate the webhook by clicking the **Activate** button.

    <Frame>
      <img src="https://mintcdn.com/stackone-60/EZ7nWzE-JJzhmP-C/images/hubspot/image7.png?fit=max&auto=format&n=EZ7nWzE-JJzhmP-C&q=85&s=9153bc10e1a8afe8ca6b400404cdc8ff" alt="Activate Event" width="2848" height="1442" data-path="images/hubspot/image7.png" />
    </Frame>
  </Step>
</Steps>

## StackOne Webhooks Configurations

<Steps>
  <Step title="Log in to StackOne Dashboard">
    Log in to your StackOne Dashboard at [https://app.stackone.com/login](https://app.stackone.com/login) and navigate to **Webhooks**

    <Frame>
      <img src="https://mintcdn.com/stackone-60/POgdaSWWHjUFRYuz/images/hubspot/image11.png?fit=max&auto=format&n=POgdaSWWHjUFRYuz&q=85&s=0f6a34c20534c73e18da62ca771c3a4e" alt="Webhooks page" width="1879" height="808" data-path="images/hubspot/image11.png" />
    </Frame>
  </Step>

  <Step title="Create Webhook">
    * To create new webhook click on **Add Webhook** button.

    <Frame>
      <img src="https://mintcdn.com/stackone-60/POgdaSWWHjUFRYuz/images/hubspot/image12.png?fit=max&auto=format&n=POgdaSWWHjUFRYuz&q=85&s=ae9d342da726118d0d47746db3f0faac" alt="Add Webhook" width="1656" height="854" data-path="images/hubspot/image12.png" />
    </Frame>

    * Enter Webhook **Name** and **URL** and click **Create**.

    <Frame>
      <img src="https://mintcdn.com/stackone-60/POgdaSWWHjUFRYuz/images/hubspot/image13.png?fit=max&auto=format&n=POgdaSWWHjUFRYuz&q=85&s=80e45152ae25592165917e2fbea184ac" alt="Create" width="1647" height="865" data-path="images/hubspot/image13.png" />
    </Frame>

    * Click **Save** to save the changes.
  </Step>

  <Step title="Configure Events">
    * Select Webhook from the list.

    <Frame>
      <img src="https://mintcdn.com/stackone-60/POgdaSWWHjUFRYuz/images/hubspot/image14.png?fit=max&auto=format&n=POgdaSWWHjUFRYuz&q=85&s=ef5828aa0f9e81227a7fb01c40b9f228" alt="Select Webhook" width="1647" height="823" data-path="images/hubspot/image14.png" />
    </Frame>

    * Go the **Events** tab.
    * To add a new event (such as Create, Update, or Delete), click the plus icon under the CRM catgory.

    <Frame>
      <img src="https://mintcdn.com/stackone-60/POgdaSWWHjUFRYuz/images/hubspot/image15.png?fit=max&auto=format&n=POgdaSWWHjUFRYuz&q=85&s=8c0df1cf07ea8a35c00874a68d229bd3" alt="Add Event" width="1858" height="836" data-path="images/hubspot/image15.png" />
    </Frame>

    * Select the event under the **HubSpot** integration and click on the *Confirm* button to save the details.

    <Frame>
      <img src="https://mintcdn.com/stackone-60/EZ7nWzE-JJzhmP-C/images/hubspot/image16.png?fit=max&auto=format&n=EZ7nWzE-JJzhmP-C&q=85&s=fee6932e7069ca7d70b92f6106b01752" alt="Confirm Event" width="1650" height="865" data-path="images/hubspot/image16.png" />
    </Frame>

    * Save the webhook by clicking the **Save** button.

    <Frame>
      <img src="https://mintcdn.com/stackone-60/EZ7nWzE-JJzhmP-C/images/hubspot/image17.png?fit=max&auto=format&n=EZ7nWzE-JJzhmP-C&q=85&s=92b591a4ade219bdd944adf7778798ff" alt="Confirm Event" width="1649" height="861" data-path="images/hubspot/image17.png" />
    </Frame>
  </Step>
</Steps>

<br />

Congratulations, you're all set!

## Useful Links

<Card title="API Reference" icon="link" href="https://developers.hubspot.com/docs/guides/api/app-management/webhooks">
  [https://developers.hubspot.com/docs/guides/api/app-management/webhooks](https://developers.hubspot.com/docs/guides/api/app-management/webhooks)
</Card>

<Card title="HubSpot Developer Portal" icon="link" href="https://developers.hubspot.com">
  [https://developers.hubspot.com](https://developers.hubspot.com)
</Card>
