Remove the associations between two provided objects

Archives a batch of selected engagements by their IDs.

Create an association between the objects identified in the step

<html>
 <head></head>
 <body>
 Send Proposal
 </body>
</html>

my_object_to_contact

my_object

my_object_property

Create a communication, email, call, meeting, note, postal mail or task engagement in HubSpot CRM.

1 year implementation consultation

Implementation Service

Delete all webhooks created by this instance in HubSpot

Begins exporting CRM data for the portal as specified in the request body.

Get a complete summary of an import record, including any updates.

Read a batch of contacts by internal ID, or unique property values.

Retrieve the information or metadata of a company by Id, domain, or name

Get the information and metadata of a contact by Id or Email

Return information about the current session's user.

Retrieve information and metadata about a deal by its Id or name

Get a communication, email, call, meeting, note, postal mail or task engagement object from HubSpot CRM.

Retrieve the information and metadata of a line item by Id

Retrieve the information and metadata of a product by Id or name

Import CRM records and activities into your HubSpot account, such as contacts, companies, and notes.

Returns a paged list of active imports for this account.

Retrieve a list of all association types available between two objects

contact_to_company

Example Company

List engagement objects from HubSpot CRM, including communications, emails, calls, meetings, notes, postal mail, and tasks.

Example Product

Retrieve a list of all configured object properties.

my_contact_property

This action allows you to make requests to any HubSpot API endpoint.
This is especially helpful for [search](https://developers.hubspot.com/docs/api/crm/search) endpoints, where objects may have custom properties that are unique to your customers.

The data that you send to HubSpot can be dynamically generated in a [code](components/code.mdx) step.
Then, you can pass the code step's results as an input reference to the `Data` input.
For example, if you are using HubSpot's search API to search for HubSpot "deals" that have the name "Sample Deal" and are valued less than 100 dollars, you can create a code step that reads like this:

```js
module.exports = async ({ logger, configVars }, stepResults) => {
  const data = {
    filterGroups: [
      {
        filters: [
          {
            propertyName: "dealname",
            operator: "EQ",
            value: "Sample Deal",
          },
          {
            propertyName: "amount",
            operator: "LT",
            value: "100",
          },
        ],
      },
    ],
    properties: [
      "hs_object_id",
      "createdate",
      "hubspot_owner_id",
      "dealstage",
      "amount",
      "dealname",
      "closedate",
      "days_to_close",
      "hs_analytics_source",
      "hs_analytics_source_data_1",
      "hs_analytics_source_data_2",
      "hs_campaign",
      "hs_closed_amount",
      "hs_lastmodifieddate",
      "dealtype",
      "description",
    ],
  };

  return { data };
};
```

On the raw request step, enter `/crm/v3/objects/deals/search` as the `URL` input, `POST` as the `Method`, and reference the code step's `results` as the `Data` input.


Get the Ids of the objects associated with those specified in the step

Use the search endpoints to filter, sort, and search objects, records, and engagements across your CRM.

Returns a list of deals that match the given properties

<html>
 <head></head>
 <body>
 Updated
 </body>
</html>

Update the information and metadata of an existing company

Update the information and metadata of an existing contact

Update the information or metadata of an existing deal

Update a communication, email, call, meeting, note, postal mail or task engagement in HubSpot CRM.

<html>
 <head></head>
 <body>
 changed
 </body>
</html>

Update an the information and metadata of an existing line item

Update the information and metadata of an existing product

Returns a boolean value that specifies whether the provided Connection is valid

The HubSpot connector accesses HubSpot data via the HubSpot REST API.This connector allows you and your customers to integrate HubSpot with your product, enabling your customers to work with deals, products, contacts, companies, line items, associations, custom objects, and more in HubSpot via those integrations.

About the HubSpot connector

HubSpot

Quickly build integrations connecting your B2B SaaS product to HubSpot.

Yes. We offer built-in connectors for a variety of other CRMs including Salesforce, Zendesk, Segment, and Zoho. These and other connectors are available from our <a href="https://prismatic.io/connectors/" rel="noopener noreferrer" target="_blank">connector library</a>.

Yes. The connector uses <a href="https://prismatic.io/docs/components/hubspot/#hubspot-oauth-20" rel="noopener noreferrer" target="_blank">OAuth 2.0</a>.

Yes. Here are the instructions for <a href="/docs/custom-components/writing-custom-components/" rel="noopener noreferrer">writing custom connectors</a> in Prismatic.

FAQs for HubSpot integrations

HubSpot Connector

### Creating an App via the CLI
The [app creation guide](https://developers.hubspot.com/docs/apps/developer-platform/build-apps/create-an-app) walks you through how to get up and running with a basic app that uses a boilerplate example project and schema definition.

Refer to this [quick reference guide](https://developers.hubspot.com/docs/getting-started/quickstart) to get started on the latest version of HubSpot’s developer platform.

1. Install the HubSpot CLI (version 7.6.0 or higher):
 ```bash
 npm install -g @hubspot/cli
 ```

2. Authenticate the CLI with your HubSpot developer account:
 ```bash
 hs account auth
 ```

3. Create a new app project:
 ```bash
 hs project create
 ```
 - Select **App** as the project template
 - Choose your distribution type (marketplace or private/specific accounts)
 - Select **OAuth** as the authentication method
 - Optionally select app features you need (Card, App Function, Settings, Webhooks, Custom Workflow Action)

4. Configure your app by editing the generated `app-hsmeta.json` file:
 - Update app name, description, and required scopes
 - Add redirect URLs for OAuth authentication

5. Upload your app project to HubSpot:
 ```bash
 hs project upload
 ```
 If you receive the following message you will need to change the directory to the project folder where the app was created:
 ```
 [ERROR] Unable to locate a project configuration file. Try running again from a project directory, or run `hs project create` to create a new project.
 ```

6. Open your project in the HubSpot developer portal to retrieve credentials:
 ```bash
 hs project open
 ```
 Navigate to the **Auth** tab to copy your **Client ID** and **Client Secret**

For more details, see the [HubSpot CLI documentation](https://developers.hubspot.com/docs/apps/developer-platform/build-apps/create-an-app).

To configure your OAuth 2.0 HubSpot connection:

- For **Client ID** and **Client Secret** enter the values from your app's Auth page
- For **Scopes** choose from the available scopes based on your integration needs (see HubSpot [OAuth documentation](https://developers.hubspot.com/docs/api/working-with-oauth) for details)
- Under the **Redirect URLs** section add <OauthCallbackUrl />

### Creating a Legacy app
Legacy apps will continue to work, but they won't receive new features or platform improvements from HubSpot.

1. Create a [HubSpot developer account](https://developers.hubspot.com/) if you don't already have one
2. Navigate to your [HubSpot developer account](https://app.hubspot.com/developer)
3. Click **Create app** to create a new public app
4. Fill in your app details (name, description, etc.)
5. Navigate to the **Auth** tab of your newly created app
6. Copy the **Client ID** and **Client Secret** from this page
7. Add your redirect URL as <OauthCallbackUrl /> to the **Redirect URLs** section
8. Configure the required scopes for your integration in the **Scopes** section

Private app access tokens are recommended for testing purposes only. For production integrations, use OAuth 2.0.
Private app access tokens do not expire but can be revoked at any time from your HubSpot account settings.

1. Log into [HubSpot](https://app.hubspot.com)
2. Navigate to **Settings > Integrations > Private Apps**
3. Click **Create a private app**
4. Enter a name for the app and configure the required scopes
5. After creating the app, navigate to the **Auth** tab
6. Copy the **Access Token** displayed
7. From the integration connection, fill in the required field:
   - **Access Token**: The token obtained from your HubSpot private app settings


The Webhook Authentication connection is used specifically for verifying HubSpot webhook signatures to ensure webhook requests are legitimate.
This connection is only used for webhook triggers and does not grant API access. It solely validates that incoming webhooks are from HubSpot by verifying the request signature.

1. Log into [HubSpot](https://app.hubspot.com)
2. Navigate to **Settings > Integrations > Private Apps**.
3. If creating a new app:
   - Click **Create a private app** or **Create an app**
   - Configure the required webhook subscriptions
4. Navigate to the **Auth** or **App Credentials** section
5. Copy the **Client Secret** value
6. From the integration connection, fill in the required field:
   - **Client Secret**: The client secret from your HubSpot app, used to verify webhook signatures
7. In the integration, ensure the trigger is configured to use the Webhook Authentication connection.

## Webhook Subscriptions

1. In your app settings, navigate to the **Webhooks** section
2. Click **Configure** or **Set up webhooks**
3. You'll need to provide:
   - **Target URL**: This is where HubSpot will send webhook events. This can be found in the **Test Configuration > Trigger Payload** section of the integration
   - **Events to subscribe to**: Select the specific events you want to monitor


Select a company from the list of companies.

Select a contact from the list of contacts.

Select an engagement from the list of engagements.

Select a line item from the list of line items.

Select a product from the list of products.

Select a property from the list of properties.

Select a webhook from the list of webhooks.

Manage records and associations in the HubSpot CRM platform

[HubSpot](https://www.hubspot.com/) is a Customer Relationship Management software for inbound marketing, sales, and customer service.
This component allows you to interact with the HubSpot REST API.

#### API Documentation

This component was built using the [HubSpot API Documentation](https://developers.hubspot.com/docs/api/overview)
