Docs

Support

Getting Started

Implementing Chargebee

Product Catalog

Subscriptions

Customers

Invoices, Credit Notes and Quotes

Taxes

Payments

Hosted Capabilities

Site Configuration

Reports and Analytics

Integrations

Data Privacy & Security

Data Operations

HubSpot FAQ

1. How are the deal close dates updated?

The deal close date property updated in HubSpot depends on the state of the subscription.

The table below describes this in detail.

Subscription state at the time of first sync	Deal stage selected in the setting	Deal's close date
Future	Any stage other than 'Closed Won'	Subscription start date
	Closed Won	Subscription create date
Active or Non renewing	Any stage	Subscription create date
In trial	Any stage other than Closed Won	Trial end date
	Closed Won	Subscription create date
	Do not sync in trial subscriptions	Subscription won't sync
Any other subscription state	N/A	Subscription won't sync

2. Will there be any impact on the deal close date property when there is a change in the subscription state?

Yes, the subscription state determines the deal close date that is updated in HubSpot. Refer to the previous faq to know more.

The below table explains the impact in detail.

Subscription's state at the time of first sync	Subscription's new state at the time of subsequent sync	Deal Close date
Future	In trial	Deal close date is not set.
Future	Active	Subscription start date if the deal is not closed. Suppose if the deal is already closed before the sync, then there is no change.
Future	Non-renewing	Subscription create date is set.
Future	Canceled	Deal close date is not set.
In trial	Active	Subscription activated date is set.
In trial	Non-renewing	Subscription create date is set.
In trial	Canceled	Deal close date is not set.
Active	Non-renewing	Deal close date is not set.
Active	Paused	Deal close date is not set.
Active	Canceled	Deal close date is not set.
Paused	Active	Subscription create date is set.
Paused	Non-renewing	Subscription create date is set.
Paused	Canceled	Deal close date is not set.
Non-renewing	Active	Deal close date is not set.
Non-renewing	Canceled	Deal close date is not set.
Canceled	Active	Subscription create date Note: The ‘Subscription create date' is set only if the canceled subscription did not have a deal in HubSpot at the time of the sync.
Canceled	Non-renewing	Subscription create date Note: The ‘Subscription create date' is set only if the canceled subscription did not have a deal in HubSpot at the time of the sync.

3. What is a future subscription in Chargebee? How are the corresponding deals for Future subscriptions created in HubSpot?

Future Subscriptions are subscriptions whose start date is in the future. To sync the information of future subscriptions, enable the option ‘Create/update deals in HubSpot for subscriptions that are in future' and then select the deal stage for the subscription in HubSpot. How the information of the future subscriptions get synced directly depends on the configuration of the setting ‘When a subscription is created in Chargebee'.

If you have selected the option:

Create a deal: A new deal is created for future subscription with the pipeline and deal stage selected in the setting.

Update a new deal: the integration checks for an existing deal and updates it with the deal stage selected in the setting. If there are no open deals, then the action configured for ‘If there are no open deals' takes place.
Do nothing: does not create a deal

Chargebee creates and updates deals in HubSpot for future subscriptions depending on their state at the time of the sync.

For example, the deal stage selected for

Future is Contract Sent
In trial is Qualified to buy
Active/Non-renewing is closed Won

Subscription's state at the time of first sync	Subscription's new state at the time of subsequent sync	Deal Behaviour
Future	In trial	Deal is first created in the stage ‘Contract Sent' and then updated to ‘Qualified to buy'.
Future	Active	Deal is first created in the stage ‘Contract Sent' and then updated to ‘Closed Won'.
Future	Non-renewing	Deal is first created in the stage ‘Contract Sent' and then updated to ‘Closed Won'.
Future	Canceled	Deal is first created in the stage ‘Contract Sent'. Please do note that, the subscription related custom properties on the deal are only updated and there is no update on the standard deal properties (such as stage).

4. How does the integration handle syncing of failed records?

The Chargebee - HubSpot integration syncs all the failed record only once every 24 hours. This is because syncing all the failed records during the hourly sync, could increase the bandwidth and cause a delay in syncing the rest of the records (error free).

During the hourly sync, the integration updates :

all the new subscriptions and customers that are created.
the subscriptions and the customers that have been edited or updated after the previous sync.

For example, the integration identifies 50 failed records on 1 October 2020, at 12 AM, then during the next hourly sync (at 1 AM):

The integration will sync all the customers and subscriptions that were created after the previous sync.
Any customer or subscription that was updated after the previous sync (between 12 AM to 1 AM).
The customers and subscriptions that were updated from the 50 failed records. Suppose 10 records of the 50 records were updated, then the integration will try to sync only the 10 records. The remaining 40 records, if updated will be synced during the consecutive hourly syncs. In case, they are not updated, Chargebee will try to sync them again on 2nd October 2020, at 12 AM.

Note

This is the case only for auto sync. You can perform the manual sync anytime by clicking the Settings > Configure Chargebee > HubSpot > Sync now.

Was this article helpful?