> This page is for Docs.

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

# Set up HubSpot connector

> Follow the steps to configure HubSpot connector in Zuora and install the HubSpot app.

Follow the steps to configure HubSpot connector in Zuora and install the HubSpot app.

In Zuora, navigate to **Marketplace** > **My Connectors** to access the HubSpot connector.

If the HubSpot connector is not listed, contact [Zuora Global Support](https://support.zuora.com/) to install it.

Enter the **HubSpot Portal ID** of your HubSpot account.

Authenticate to Zuora using the provided **Client ID** and **Client Secret**. See [Create an OAuth client for a user](/docs/platform/security-and-identity/administrator-settings/manage-users/create-an-oauth-client-for-a-user).

1. Set the environment to the REST Zuora endpoint. For example, rest.apisandbox.zuora.com.
2. Generate Zuora credentials.

Enter the Zuora environment endpoint. For example, `rest.apisandbox.zuora.com` in the **Zuora_host** field.

Set up the custom field mapping. See [HubSpot synchronization with custom fields](/docs/platform/integration/integration-hub/advanced-connectors/billing-connector-for-hubspot/hubspot-synchronization-custom-fields).

If there is no mapping, assign an empty array( **\[ ]** ) to the mapping field.

The mandatory configuration requires the addition of custom fields as follows:

1. In the contact section, create an indexed custom field with the API name **crmId\_\_c**. Set the field type as **Text** with a length of **255**.
2. In the subscription section, create an indexed custom field with the API name **hubspotDealId\_\_c**. Set the field type to **Text** with a length of **255**.

Contact [Zuora Global Support](https://support.zuora.com/) to obtain the installation URL for the HubSpot app.

Use the provided URL for one-step installation of the app in your HubSpot instance.