Docschargebeedocs

HomeBillingPaymentsRevRecGrowthReveal
Support

Product Updates


  • Release Notes

Getting Started


  • Overview
  • Chargebee Billing Data Centers
  • Object Relationship Model
  • Understanding Sites
  • Developer Resources
  • Chargebee Tech Glossary
  • Articles and FAQ

Implementing Chargebee


  • Implementation Guide
  • Go-live Checklist
  • Articles and FAQ

AI in Chargebee


  • Chargebee Agents
  • Chargebee Copilot
  • Chargebee MCP Server (Model context protocol)

Product Catalog


  • Product Catalog Overview
  • Coupons
  • Articles and FAQ

Subscriptions


  • Working with Subscriptions
  • Billing
  • Orders
  • Articles and FAQ

Customers


  • Managing Customers
  • Account Hierarchy
  • Email Notifications
  • Branding
  • Configure Multiple Languages
  • Articles and FAQ

Invoices, Credit Notes and Quotes


  • Invoices
  • Credit Notes
  • Quotes [Legacy]
  • Transactions
  • Articles and FAQ

Taxes


  • Overview
  • Configuring Taxes
  • Country-specific Taxes
  • Articles and FAQ

Hosted Capabilities


  • Overview
  • Hosted Checkout
  • Hosted Self-Serve Portal
  • Hosted Pages Features
  • Additional Hosted Pages
  • Payment Components
  • Managing payments with ChargebeeJS
  • Mobile-Optimized Hosted Pages
  • Articles and FAQ

Site Configuration


  • Users & Roles
  • Custom Fields & Metadata
  • Mandatory Fields
  • File Attachments & Comments
  • Advanced Filter Options
  • Multicurrency Pricing
  • Multi-decimal Support
  • Configuring Reason Codes
  • Events and Webhooks
  • API Keys
  • Time Zone
  • Time Machine
  • Transfer Configurations
  • Articles and FAQ

Reports and Analytics


  • RevenueStory
  • Home Dashboard
  • Frequently Asked Questions
  • FAQs for Classic Reports Sunset
  • Articles and FAQ

Integrations


  • Sales
    • Salesforce (v1.38+)
    • Salesforce (v1.37)
    • HubSpot
      • HubSpot Configuration
      • Chargebee Actions in HubSpot
      • HubSpot Release Notes
      • HubSpot FAQ
      • Troubleshooting Sync Errors
    • Pipedrive
  • Customer Support and Success
  • Finance
  • Tax
  • Marketing
  • Stitch
  • Collaboration
  • Contract Management
  • Order Management
  • Mobile Subscriptions (Legacy)
  • Other Integrations
  • Articles and FAQ

Data Privacy & Security


  • Two Factor Authentication
  • SAML Single Sign-On
  • System for Cross-Domain Identity Management (SCIM)
  • EU-GDPR
  • Consent Management
  • Personal Data Management
  • Compliance Certificates
  • HIPAA Guidelines
  • PCI Recommendations and Integration Types
  • Articles and FAQ

Data Operations


  • Bulk Operations
  • Migration
  • Articles and FAQ
  1. Billing
  2. Integrations
  3. Sales
  4. HubSpot
  1. Billing
  2. Integrations
  3. Sales
  4. HubSpot

HubSpot

HubSpot CRM enables you to kickstart your sales process automatically by tracking customer interactions from a variety of sources such as email, social media, and more. This lightweight CRM gives you the latest information on deals won and lost, appointments scheduled, and contracts.

Chargebee provides a seamless integration with HubSpot that helps you to:

  • Connect up to five Chargebee sites with HubSpot.
  • Sync subscription and customer information in Chargebee with HubSpot CRM.
  • Create deals in HubSpot when a subscription is created in Chargebee.
  • Create contacts and subscriptions in Chargebee from HubSpot.

Prerequisites

  • Chargebee does not create companies in HubSpot CRM. HubSpot provides a setting that automatically populates the contact's associated company either from the domain name or email address. It is recommended that you enable the setting.
  • Ensure that you configure the same set of currencies in Chargebee and HubSpot. This is necessary because the deal amount in HubSpot is updated based on the currency configured for the corresponding subscription. In case the currency set for a subscription is not configured in HubSpot, the deal amount is updated as per the subscription but the currency displayed is the base currency. Example: The subscription amount is CAD 25. If you have not configured CAD as a currency in HubSpot, then the deal amount is updated with your base currency - USD 25 (assuming USD is your base currency.)

Types of Account

You can configure the Chargebee - HubSpot integration both in Chargebee's test site as well as the Live site. We recommend you to first test the synchronization of data from Chargebee test site to a test account in HubSpot CRM.

Object Mapping

The following objects in HubSpot CRM are updated upon setting up this integration.

  • Contact
  • Deals
  • Company
image

In addition to syncing information from Chargebee to HubSpot, the integration also allows customer and subscription records in Chargebee to be created from within HubSpot.

Field Mapping

Chargebee objects are mapped to some standard HubSpot objects. The below tables will give you a detailed mapping relationship between objects in Chargebee and HubSpot.

Contacts

The table below shows how properties in the contact object in HubSpot are mapped to fields in Chargebee:

HubSpot Property GroupHubSpot PropertyChargebee Field
Contact informationEmailEmail
First NameFirst Name
Last NameLast Name
Phone numberPhone
Company nameCompany name
Lifecycle stage

The stage that you have set up in Sync rules for contacts.

Chargebee customer infoChargebee customer IDCustomer ID
Chargebee Site Name

The subdomain name of the Chargebee site to which the customer belongs. For example, if your site is https://acmecompany.chargebee.com then this property will have the value acmecompany.

Billing AddressBilling Address
Billing CityBilling City
Billing StateBilling State
Billing CountryBilling Country
Billing ZipBilling Zip
Auto collectionAuto collection
PreferredCurrencyCodePreferred Currency Code
PaymentMethod StatusPayment Method Status
PaymentMethod TypePayment Method Type
net_term_daysnet_term_days
Tax exempt statusTax exempt status
First name (billing)First name
Last name (billing)Last name
Email (billing)Email
Phone number (billing)Phone number
Billing State (ISO code)Billing State
Billing Country (ISO code)Billing Country
Subscription Information (Contact object in HubSpot and Subscription in Chargebee)Subscription IDSubscription ID
Subscription statusSubscription status
Subscription MRRSubscription MRR
ProductProduct
Plan quantityPlan quantity
Setup feeSetup fee
Due invoices countDue invoices count
Remaining billing cyclesRemaining billing cycles
PO numberPO number
Next billing atNext billing at
Next billing amountNext billing amount
Total duesTotal dues
Due sinceDue since
Chargebee Order Information (Contact object in HubSpot and Orders in Chargebee)Last order dateFetches the order date closest to, but before the current date and time.
Last order AmountFetches the order amount of the last order.
Last order base component SKUFetches the SKU for the line item based on the last order
Last order statusFetches the status of the last order
Next order dateFetches the order that is closest to & after the current date and time
Next order $Fetches the order amount of the next order.
Next order base component SKUFetches the SKU for the line item based on the next order
Next order statusFetches the status of the next order

Chargebee Order Information property group is applicable only if you are using Shipping orders.

Company

The company object has some custom properties synced from Chargebee. However, they're a legacy feature and it is recommended that they no longer be used to derive any useful information for company records.

Deals

HubSpot Property GroupHubSpot PropertyChargebee Field
Chargebee subscription informationSubscription IDSubscription ID
Chargebee site name

The subdomain name of the Chargebee site to which the customer belongs. For example, if your site is https://acmecompany.chargebee.com then this property will have the value acmecompany.

Subscription statusSubscription status
Subscription MRRSubscription MRR
ProductThe Base Plan associated with the subscription is
Plan quantityPlan quantity
Setup feeSetup fee
Due invoices countDue invoices count
Remaining billing cyclesRemaining billing cycles
PO numberPO number
Next billing atNext billing at
Next billing amountNext billing amount
Total duesTotal dues
Due sinceDue since
Deal Information (Deal object in HubSpot and Subscription in Chargebee)AmountThe recurring total of the subscription.
Deal nameNew Sale for [company/contact name]
Deal stage

If a trial subscription syncs, an interim deal stage can be chosen. If an active subscription syncs, deal stage will be closed won.

Articles & FAQs

Auto-populating fields in Chargebee checkout link generated via Hubspot
When and how often are products synced in new Hubspot integration?
HubSpot Deal → Chargebee Subscription - new Hubspot integration
What are the types of subscription amendments available with HubSpot Q2C integration?
I can see few Scheduled Activity customer modified events not triggered by Chargebee
Hubspot Sync failure emails
Salesforce - Error “Custom Setting Name too long:” while adding Chargebee domain id for the test instance
Access for the Salesforce org has expired for ChargebeeInc Support
'Hubspot error: There was a problem displaying this content. Try refreshing the page. If this issue persists, contact your app developer for assistance.'
Bad picklist value error - Salesforce
'Fix for error message: locale-not in allowed values Salesforce'
How to perform the Anrok integration in Chargebee?
What are the prerequisites for Hubspot integration?
Hubspot - Pipeline or stage errors
Hubspot -Authentication error
Hubspot - Internal error
Hubspot - PII data cleared error
Hubspot - Contact already mapped error
Hubspot - Contact not found error
Hubspot - Contact missing error
Hubspot - Unique field value missing error
Hubspot - Customer deleted error
Hubspot - Unknown error
How to integrate Clickfunnels and Chargebee?
Hubspot - No open deal found error
Limitation of new Hubspot integration
Prerequisites for Generating a Checkout Link via HubSpot Automation Trigger
How do I resolve duplicate SKU errors when uninstalling HubSpot integration?
How do I link a HubSpot deal to a company for subscription renewals?
Prerequisites for Generating a Checkout Link via HubSpot Automation Trigger
Why does the HubSpot sync error "Entity is synced already" occur?
How do I resolve the 'XI' country code sync error with HubSpot?

Show more

Was this article helpful?