New in Chargebee: Explore Reveal and understand your payment performance end-to-end.Try Now
Docschargebee docs
HomeBillingCPQPaymentsRevRecGrowthReveal
Support

Product Updates

  • Release Notes

Getting Started

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

Implementing Chargebee

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

Agentic AI

  • Chargebee Copilot
  • Catalog Setup Assistant
  • MCP Servers

Developer Resources

  • Developer Resources Overview
  • API Explorer
  • Articles and FAQ

Chargebee Apps

  • Chargebee Apps CLI Developer Guide

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

Entitlements

  • Entitlements Overview
  • Features Overview
  • Feature Management
  • Managing Product Entitlements
  • Subscription Entitlements
  • Customer Entitlements
  • Grandfathering Entitlements
  • Articles and FAQ

Usage Based Billing

  • Overview
  • Use Cases
  • Setting up Usage Based Billing
  • Usage Alerts
  • Prepaid credits
  • Mid-term Subscription Changes
  • FAQs

Invoices and Credit Notes

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

Taxes

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

E-Invoicing

  • Overview
  • Enabling E-Invoicing

Hosted Capabilities

  • Overview
  • Hosted Checkout
  • Hosted Self-Serve Portal
  • Hosted Pages Features
  • Additional Hosted Pages
  • Payment Components
  • Pricing Table
  • Mobile SDKs and Wrappers
  • Articles and FAQ

Site Configuration

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

Multi Business Entity

  • Multi Business Entity Overview
  • Customer Transfer Overview
  • Articles and FAQ

Mobile Subscriptions

  • Overview
  • Omnichannel Subscriptions
  • Omnichannel Subscriptions (Legacy)

Reports and Analytics

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

Integrations

  • Sales
  • Customer Support and Success
  • Finance
  • Tax
  • E-Invoicing
  • Marketing
  • Stitch
  • Collaboration
  • Contract Management
  • Ecommerce Management
  • 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
  3. Integrations
  5. Articles and FAQ
  6. HubSpot
  1. Billing
  3. Integrations
  5. Articles and FAQ
  6. HubSpot

Problem statement

Billing information from HubSpot does not sync to Chargebee unless all billing address fields are filled in. This issue prevents merchants from creating subscriptions when certain address fields, such as ZIP codes, are unavailable or not applicable for some countries.

Related scenarios

  • You’re trying to sync billing information between HubSpot and Chargebee, but some address fields (like ZIP code) are not required for certain countries.
  • You want to ensure billing details sync successfully even when some fields are left blank.

Solution

By default, Chargebee’s HubSpot integration requires that all billing address fields be filled in before syncing data to Chargebee. If any required field (such as ZIP code) is missing, the sync fails silently.

In HubSpot, the billing address mapping appears as shown below:

image

Below is an example of the Company Information and Chargebee Company Information sections in HubSpot, showing the corresponding billing address fields:

image

To fix this, Chargebee can enable a backend configuration that allows billing information to sync even when certain address fields are blank.

Setup instructions

  1. Confirm your requirement
    Verify that you want to sync billing data from HubSpot even if some fields, such as ZIP code, are empty.

  2. Contact Chargebee support
    Reach out to Chargebee Support and request to enable the backend property that bypasses the “all fields required” condition for billing address syncs.

  3. Trigger a manual sync
    After the property is enabled, make a small update to the corresponding company record in HubSpot.
    This update triggers a manual sync with Chargebee.

  4. Validate the sync
    Wait about 15 minutes for the sync to complete.
    Then, check the corresponding customer record in Chargebee to confirm that the billing address has been updated successfully.

Additional information

Once this backend property is enabled, billing information syncs to Chargebee even if some address fields are blank. This setup ensures smoother synchronization and supports regional variations where ZIP codes or similar fields are not required.

Was this article helpful?