HubSpot sync error: XI was not one of the allowed options

Problem statement

This article helps you resolve the HubSpot sync error:

XI was not one of the allowed options.

This error occurs when Chargebee tries to sync a field value (for example, a country code) that is not part of the allowed options configured for the corresponding property in HubSpot.

Note: In this case, they are trying to sync the billing address fields based on the sync rule. However, the value they’re attempting to sync for the customer record is not among the allowed options defined for that HubSpot field property.

Related scenarios

This issue can occur for any dropdown or single-select field where the values in Chargebee and HubSpot do not match.
Common examples include:

• Syncing a country code such as “XI” instead of a full country name (for example, United Kingdom)

• Sending boolean values like true/false that do not match HubSpot’s case-sensitive field options

• Sending a custom value not added to HubSpot’s property options

Solution

The error typically occurs because Chargebee sends the country code “XI” (ISO code for United Kingdom – Northern Ireland), while HubSpot only recognizes “United Kingdom” as a valid value for the country field.

To fix this, you can either:

1. Update the country value in Chargebee to match an allowed option in HubSpot (for example, change “XI” to “United Kingdom”).

2. Add “XI” or “United Kingdom (Northern Ireland)” as an allowed value in the corresponding HubSpot property (for example, Billing Country).

Steps to resolve the issue

1. Identify affected records

   • Go to Chargebee > Integrations > HubSpot > Sync Logs.

   • Locate the failed sync entries showing the error “XI was not one of the allowed options.”

2. Verify the billing country value

   • In Chargebee, open the affected Customer record.

   • Select Edit Customer or Update Billing Info.

   • Check the Billing Country field value.

   • If it shows XI, update it to United Kingdom (or a valid equivalent that exists in HubSpot).

3. Update allowed options in HubSpot (optional)

   • In HubSpot, navigate to Settings > Properties.

   • Locate the property used for the billing country (for example, Billing Country).

   • Add XI or United Kingdom (Northern Ireland) as an additional allowed value.

4. Retry the sync

   • Return to the Chargebee > HubSpot Sync Logs page.

   • Click Retry Sync for the affected records.

   • Confirm that the sync completes successfully.