Docs

Log in to read the version of docs relevant to your site, or use the dropdown versions

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 syncDeal stage selected in the settingDeal's close date
FutureAny stage other than 'Closed Won'Subscription start date
-Closed WonSubscription create date
Active or Non renewingAny stageSubscription create date
In trialAny stage other than Closed WonTrial end date
-Closed WonSubscription create date
-Do not sync in trial subscriptionsSubscription won't sync
Any other subscription stateN/ASubscription 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 syncSubscription's new state at the time of subsequent syncDeal Close date
FutureIn trialDeal close date is not set.
FutureActiveSubscription start date if the deal is not closed. Suppose if the deal is already closed before the sync, then there is no change.
FutureNon-renewingSubscription create date is set.
FutureCanceledDeal close date is not set.
In trialActiveSubscription activated date is set.
In trialNon-renewingSubscription create date is set.
In trialCanceledDeal close date is not set.
ActiveNon-renewingDeal close date is not set.
ActivePausedDeal close date is not set.
ActiveCanceledDeal close date is not set.
PausedActiveSubscription create date is set.
PausedNon-renewingSubscription create date is set.
PausedCanceledDeal close date is not set.
Non-renewingActiveDeal close date is not set.
Non-renewingCanceledDeal close date is not set.
CanceledActiveSubscription 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.
CanceledNon-renewingSubscription 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 syncSubscription's new state at the time of subsequent syncDeal Behaviour
FutureIn trialDeal is first created in the stage 'Contract Sent' and then updated to 'Qualified to buy'.
FutureActiveDeal is first created in the stage 'Contract Sent' and then updated to 'Closed Won'.
FutureNon-renewingDeal is first created in the stage 'Contract Sent' and then updated to 'Closed Won'.
FutureCanceledDeal 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?