---
schema_version: "1"
id: 5e93bc131405f7f38083cdd097bf43a9c3d0ac42a9e79aa616c66a3ff614563e
title: HubSpot Connector
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/platform/264-0-0/automate_flow_ref_third_party_hubspot.md
canonical_url: https://help.salesforce.com/s/articleView?id=platform.automate_flow_ref_third_party_hubspot.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 805946ebcdf08b6f6c31f72fa635dacb13a94748c4261d2f55a3746d4bbb4f8d
description: Connect to an external HubSpot account. Perform tasks like syncing deals or creating marketing events. Use HubSpot as a data source (trigger) or a data target (action).
products:
  - Flow Builder
  - Salesforce Platform
release: "264"
---
# HubSpot Connector

Connect to an external HubSpot account. Perform tasks like syncing deals or creating marketing events. Use HubSpot as a data source (trigger) or a data target (action).

### Required Editions

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small edition"><colgroup><col></colgroup><tbody><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;"><a href="https://help.salesforce.com/s/articleView?id=platform.flow_ref_supported_editions.htm&amp;release=264.0.0&amp;type=5" title="Learn about the editions and user interfaces that support Flow Builder. Some Flow Builder features integrate with other Salesforce products that require additional licenses.">View supported editions.</a></td></tr><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">This feature requires the MuleSoft for Flow: Integration add-on. Exceptions are segment-triggered flows, activation-triggered flows, and broadcast flows, which don't require the MuleSoft for Flow: Integration add-on. <strong>Professional</strong> Edition requires the API access add-on. To purchase an add-on, contact your Salesforce account executive.</td></tr><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">MuleSoft for Flow: Integration features used with Agentforce require the Foundations or Agentforce 1 edition. To purchase these editions, contact your Salesforce account executive.</td></tr></tbody></table>

![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-platform-platform_automation-264-0-0-production-enus/60568438-ec7e-4665-acd1-7c80dcbe60d5/images/icon_note.png)

Note You can edit or delete connections only in the Automation app.

## Connections

To connect to a system, whether it's a data source or a data target, create a connection with that system's required credentials. You can connect to multiple systems within a flow and reuse each connection. You can create connections in the [Integrations tab](https://help.salesforce.com/s/articleView?id=platform.automate_ala_connections.htm&release=264.0.0&type=5 "The Integrations tab includes a list of all the connections for your org.") or in Flow Builder.

**Standard Connection**

This system uses Bearer authentication.

Bearer authentication sends a header named Authorization with a value of Bearer and a token with every request.

This system requires this credential information for its [connections](https://help.salesforce.com/s/articleView?id=platform.automate_ala_connections_create_connection.htm&release=264.0.0&type=5).

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small ">
        <colgroup>
          <col style="width:50%">
          <col style="width:50%">
        </colgroup>
        <thead class="slds-text-title_caps ">
          <tr class="">
            <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d137279e101">FIELD</th>
            <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d137279e104">DESCRIPTION</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="FIELD" class="slds-cell-wrap" style="vertical-align:top;" headers="d137279e101 ">Connection Name</td>

            <td data-label="DESCRIPTION" class="slds-cell-wrap" style="vertical-align:top;" headers="d137279e104 ">
              <p dir="ltr">Enter a unique connection name that helps you remember the details of
                this connection. Salesforce hides the credentials after you create the connection.
                Reuse connections as needed.</p>
              <p style="margin-bottom:0;" dir="ltr">Anyone with the Manage Integration Connections permission can see and
                use all connections in the org.</p>
            </td>

          </tr>
          <tr class="">
            <td data-label="FIELD" class="slds-cell-wrap" style="vertical-align:top;" headers="d137279e101 ">Token</td>

            <td data-label="DESCRIPTION" class="slds-cell-wrap" style="vertical-align:top;" headers="d137279e104 ">
              <p>Enter the bearer token to use to authenticate the requests. </p>
              <p>To find an
                existing token, log in to HubSpot and select <strong class="uicontrol">Development</strong> &gt;
                <strong class="uicontrol">Legacy Apps</strong>. Select your app, and in
                <strong class="uicontrol">Auth</strong>, select <strong class="uicontrol">Show token</strong> to reveal
                and copy the token.
              </p>
              <p style="margin-bottom:0;">To generate a new token, log in to HubSpot and select
                <strong class="uicontrol">Settings</strong> &gt; <strong class="uicontrol">Integrations</strong> &gt;
                <strong class="uicontrol">Private Apps</strong>. Select <strong class="uicontrol">Legacy apps</strong> &gt;
                <strong class="uicontrol">Create legacy app</strong>, and select
                <strong class="uicontrol">Private</strong>. Configure the required scopes and permissions,
                and then generate and copy the access token.
              </p>
            </td>

          </tr>
          <tr class="">
            <td data-label="FIELD" class="slds-cell-wrap" style="vertical-align:top;" headers="d137279e101 ">URL</td>

            <td data-label="DESCRIPTION" class="slds-cell-wrap" style="vertical-align:top;" headers="d137279e104 ">
              <p style="margin-bottom:0;">Enter the URL of your instance.</p>
            </td>

          </tr>
        </tbody>
      </table>

**Named Credential Connection**

Select a pre-existing named credential from Setup to use for your external system connections.

Before connecting to your external system with a named credential, first create or use an existing authenticated [named credential and external credential that is enabled for your users.](https://help.salesforce.com/s/articleView?id=xcloud.nc_named_creds_and_ext_creds.htm&type=5&language=en_US)

To ensure a successful [connection](https://help.salesforce.com/s/articleView?id=platform.automate_ala_connections_create_connection.htm&release=264.0.0&type=5 "Select a named credential from Setup to use for your external system connections.") for use in a flow, use only one principal for each named credential.

- Use the same name for the named credential and its related objects, such as the external credential and external authentication identity providers. Labels for these objects can differ.
- Assign the user creating the connection the required user permission for the principal. Without this permission, the connection test fails and the connection remains inactive.

![Important](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-platform-platform_automation-264-0-0-production-enus/60568438-ec7e-4665-acd1-7c80dcbe60d5/images/icon_important.png)

Important

When you create a connection with an existing named credential, note these behaviors:

- Manage the named credential’s read-only details in Setup, not the Integrations tab. On the Integrations tab, you can only edit the connection's Connection Name and Description.
- Perform reconnections for the named credential in Setup. The Reconnect button isn’t visible on the Details page.
- Delete associated named credentials in Setup. Deleting a connection doesn't remove the credential.

## Triggers

A trigger initiates the flow when a specified event occurs. Triggers are important for automating business processes because they react to real-time data changes in various systems. For more information about triggers, refer to [Create a Flow with a Connector as a Trigger](https://help.salesforce.com/s/articleView?id=platform.automate_build_flow_esct_third_party_as_trigger.htm&release=264.0.0&type=5 "To trigger a flow when a change happens in a third-party system, use an External System Change-Triggered flow. A poller checks for new records on a schedule and creates flow interviews when records are found. Create the flow from scratch or from a template.").

These HubSpot triggers are available in Flow Builder.

- On Create Company
- On Create Deal
- On New Contact
- On New Or Update Product
- On New Or Update Ticket
- On New Product
- On New Ticket
- On New Or Update Company
- On Update Contact
- On New Or Update Deal

## Actions

An action performs a specific task or operation within a target system. Use actions to automate tasks across different systems without manual intervention, based on conditions set in the flow. For more information about actions, refer to [Create a Flow with a Connector as an Action](https://help.salesforce.com/s/articleView?id=platform.automate_build_flow_esct_third_party_as_action.htm&release=264.0.0&type=5 "To integrate your flow with an external system, add MuleSoft for Flow: Integration connectors as actions to all existing flow types. You can add connectors to flows that trigger external system changes, records, schedules, Data Cloud-triggered flows, or autolaunched flows.").

These HubSpot actions are available in Flow Builder.

- Adds A User
- Create Association
- Create Call
- Create Call With Custom Fields
- Create Company
- Create Company With Custom Fields
    
    ![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-platform-platform_automation-264-0-0-production-enus/60568438-ec7e-4665-acd1-7c80dcbe60d5/images/icon_note.png)
    
    Note
    
    Create new companies including custom property values.
- Create Contact
- Create Contact With Custom Fields
    
    ![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-platform-platform_automation-264-0-0-production-enus/60568438-ec7e-4665-acd1-7c80dcbe60d5/images/icon_note.png)
    
    Note
    
    Allows users to create new contacts while supplying custom property values. Both standard and custom properties can be provided. Custom properties must already exist in HubSpot. Validation follows HubSpot property definitions.
- Create Deal
- Create Deal With Custom Fields
    
    ![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-platform-platform_automation-264-0-0-production-enus/60568438-ec7e-4665-acd1-7c80dcbe60d5/images/icon_note.png)
    
    Note
    
    Create new deals while supplying custom property values.
- Create Default Association
- Create Email
- Create Marketing Event
- Create Product With Custom Fields
- Delete Call
- Delete Company
- Delete Contact
- Delete Deal
- Delete Email
- Delete Marketing Event
- Delete Marketing Event Batch
- Get Call
- Get Call With Custom Fields
- Get Company
- Get Company With Custom Fields
    
    ![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-platform-platform_automation-264-0-0-production-enus/60568438-ec7e-4665-acd1-7c80dcbe60d5/images/icon_note.png)
    
    Note
    
    Retrieve a company record including all configured custom properties.
- Get Contact
- Get Contact With Custom Fields
    
    ![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-platform-platform_automation-264-0-0-production-enus/60568438-ec7e-4665-acd1-7c80dcbe60d5/images/icon_note.png)
    
    Note
    
    Retrieves a contact record including standard properties and all associated custom properties. Custom properties are included in the response payload.
- Get Deal
- Get Deal With Custom Fields
    
    ![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-platform-platform_automation-264-0-0-production-enus/60568438-ec7e-4665-acd1-7c80dcbe60d5/images/icon_note.png)
    
    Note
    
    Retrieve a deal record including both standard and custom properties.
- Get Email
- Get Marketing Event
- Get Product With Custom Fields
- List Calls
- List Calls With Custom Fields
- List Companies
- List Companies With Custom Fields
- List Contacts
- List Contacts With Custom Fields
- List Deals
- List Deals With Custom Fields
- List Emails
- List Products With Custom Fields
- Modifies A User
- Patch Marketing Event
- Retrieve Account Details
- Retrieves A List Of Users From An Account
- Search Marketing Events
- See Details About This Accounts Teams
- Update Call
- Update Call With Custom Fields
- Update Company
- Update Company With Custom Fields
    
    ![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-platform-platform_automation-264-0-0-production-enus/60568438-ec7e-4665-acd1-7c80dcbe60d5/images/icon_note.png)
    
    Note
    
    Update existing companies along with their custom properties. Supports partial updates. Validation enforced as per HubSpot property configuration.
- Update Contact
- Update Contact With Custom Fields
    
    ![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-platform-platform_automation-264-0-0-production-enus/60568438-ec7e-4665-acd1-7c80dcbe60d5/images/icon_note.png)
    
    Note
    
    Allows updating existing contacts including custom properties. Supports partial updates. Only supplied properties are modified. Invalid property names or mismatched data types will return HubSpot API errors.
- Update Deal
- Update Deal With Custom Fields
    
    ![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-platform-platform_automation-264-0-0-production-enus/60568438-ec7e-4665-acd1-7c80dcbe60d5/images/icon_note.png)
    
    Note
    
    Update existing deals including custom properties.
- Update Email
- Update Marketing Event
- Update Product With Custom Fields

![Tip](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-platform-platform_automation-264-0-0-production-enus/60568438-ec7e-4665-acd1-7c80dcbe60d5/images/icon_tip.png)

Tip For more information about the API, see the external system's API documentation.

![Important](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-platform-platform_automation-264-0-0-production-enus/60568438-ec7e-4665-acd1-7c80dcbe60d5/images/icon_important.png)

Important

For information about specific limitations for connections and third-party connectors, see [MuleSoft for Flow: Integration Limits & Considerations](https://help.salesforce.com/s/articleView?id=platform.automate_flow_considerations_mulesoft_for_flow_limits.htm&release=264.0.0&type=5 "When establishing connections to external systems, keep these limitations in mind.").