Skip to main content

Get started with the HubSpot connector


Get started with the HubSpot connector

The HubSpot bi-directional Connector establishes a robust integration link between your HubSpot and subscription billing systems. This integration streamlines data synchronization by automating the connection of HubSpot's company details, contacts, deals, and product catalog with corresponding entities in Zuora.

HubSpot to Zuora synchronization

The synchronized data objects between HubSpot and Zuora include:

  • Company: HubSpot accounts can be mirrored and synchronized with Zuora using the customer account entity. Additionally, custom fields linked to the HubSpot account can be transferred and seamlessly integrated into the Zuora account structure.
  • Contact: HubSpot-generated contacts can be synced with Zuora as contacts in the billing account structure.HubSpot contact entry is optional for synchronization.
  • Deal: HubSpot deals are contracts between merchants and customers. Zuora converts these deals, possibly with multiple products, into subscriptions. Zuora's product catalog integrates and manages every product associated with the deals in HubSpot, facilitating streamlined billing, payment, and service management.
  • Product Catalog: The Zuora Connector for HubSpot allows you to administer your product catalog within HubSpot. This catalog data can seamlessly sync with Zuora, translating the product information and pricing structures into product, rate plans, charges, and charge tiers. This interconnected information is directly associated with deals and converted into subscriptions within Zuora, streamlining billing, payments, and service provisions in the platform.

Zuora to HubSpot synchronization

This sync is designed to support the backlinking of objects from Zuora to HubSpot on the CRM cards in HubSpot after the data has been synced from HubSpot to Zuora. This ensures easy data retrieval and provides a summary of Zuora’s objects from HubSpot. The CRM cards available in HubSpot’s offerings for Company and Deals include:

  • Zuora Account
  • Zuora Subscriptions
  • Zuora Orders
  • Zuora Invoices
  • Zuora Credit Memo
  • Zuora Debit Memo

Each CRM card will include crucial business data and a link to redirect to the Zuora object.

High-Level architecture of Zuora-HubSpot connector

The integration framework provides a seamless harmonization between the Zuora and HubSpot systems, allowing for configurable field mapping and the ability to sync data in both directions for consistent updates.

Hubspot connec.jpg

Configure HubSpot connector in Zuora

  1. Go to Marketplace > My Connectors to access all connectors. If the HubSpot connector isn't available in the list, raise a support ticket to install it.
  2. Enter the HubSpot Portal ID of your HubSpot account.
  3. Authenticate to Zuora using the provided Client ID and Client Secret. Set the environment to the REST Zuora endpoint. For example, Generate Zuora credentials by following the steps outlined in the Zuora Knowledge Center guide.
  4. Enter the Zuora environment endpoint—for example, in the Zuora_host field.
  5. To setup the custom field mapping see, Synchronize custom fields. If there is no mapping, assign an empty array( [ ] ) to the mapping field. 
  6. The mandatory configuration requires the addition of custom fields. To do this,
    • In the contact section, add a custom field with the API name crmId__c. Set the field type as String with a length of 255.
    • In the subscription section, create a custom field with the API name hubspotDealId__c. Set the field type to String with a length of 255.

Set up HubSpot integration

  1. Raise a support ticket in Zuora to obtain the installation URL for the HubSpot app.
  2. Use the provided URL for one-step app installation in your HubSpot instance.