Skip to content
English
Go to apiant.com
  • There are no suggestions because the search field is empty.

CRMConnect v3.6 – International Phone Number Formatting (Mindbody → HubSpot)

CRMConnect v3.6 automatically formats Mindbody phone numbers into international E.164 format for HubSpot by adding the correct country code using either the client’s Mindbody country or your default ISO country setting. This ensures clean, valid, and country-recognized phone numbers in HubSpot without requiring any changes to your automations.

Applies to: CRMConnect – Mindbody <-> HubSpot
Version: v3.6 and later
Audience: CRMConnect users (no builder access required)

1. What this enhancement does

Starting with CRMConnect v3.6, your Mindbody → HubSpot sync can now automatically:

  • Add the correct country calling code (e.g. +1, +44, +61) to phone numbers.
  • Store phone numbers in HubSpot in standard international format (E.164) so HubSpot recognizes the number, the country, and marks it as valid.
  • Use either:
    • The client’s country from Mindbody, or
    • A default country you define in CRMConnect settings.

This is all handled inside the product; you don’t need to change your automations or write any code. It’s an example of the “deep integration” logic that powers all APIANT API Apps.

2. Why this matters

Before v3.6

  • Mindbody stores phone numbers as local numbers (no +country code).
  • CRMConnect simply copied that number into HubSpot.
  • HubSpot often showed warnings like “wrong format” and could not reliably:
    • Detect the client’s country
    • Use phone tools that rely on standardized numbers

With v3.6 enabled

  • CRMConnect rebuilds the number with the correct +country code.
  • The same, correctly formatted number is written into:
    • HubSpot Phone number
    • HubSpot Mobile phone number
  • HubSpot can now validate the number and recognize the country, which improves:
    • Data quality and reporting
    • Calling / dialer behavior
    • Filtering and segmentation based on phone properties

3. How CRMConnect formats phone numbers

When a Mindbody client is created or updated and CRMConnect syncs them to HubSpot, the phone number is handled as follows:

  1. Check your setting

    • If “Add CountryCode prefix to Phone” = OFF
      → CRMConnect sends the raw Mindbody phone (no changes).
    • If ON
      → CRMConnect will build a full international number.

  2. If “Add CountryCode prefix to Phone” is ON
    CRMConnect will:

    1. Look at the client’s country in their Mindbody address.
    2. If the client has a country:
      • Convert that to the proper 2‑letter country code (e.g. “United States” → US).
      • Rebuild the phone number in E.164 format, e.g. 3105551234 → +13105551234.
    3. If the client has no country in Mindbody:
      • Use your default ISO CountryCode from CRMConnect settings (e.g. US, GB, AU) to rebuild the number.
    4. Save and send that international number to HubSpot.

  3. HubSpot result
    After the sync, in HubSpot you’ll see:

    • Phone = +<country code> <number>
    • Mobile phone = same E.164 formatted value

    HubSpot should now show the phone number as valid, and the country will be recognized automatically.

Behind the scenes, CRMConnect uses the same reusable “API App” patterns that power other advanced features like next‑appointment logic and multi‑location sync.

4. New settings in v3.6

You control this behavior from the CRMConnect settings screen.

  1. Go to your CRMConnect (Mindbody → HubSpot) configuration.
  2. Open the HubSpot settings section.

You’ll see two new settings:

4.1. Add CountryCode prefix to Phone

  • Type: Checkbox / On–Off toggle
  • What it does:
    • ON – CRMConnect will automatically:
      • Add the correct country calling code based on Mindbody or your default.
      • Store phone numbers in E.164 format in HubSpot.
    • OFF – CRMConnect will:
      • Leave the phone number exactly as it appears in Mindbody.
      • Send that local number directly to HubSpot.

Recommended: Turn this ON unless you have a strong reason to keep purely local numbers in HubSpot.

4.2. ISO CountryCode

  • Type: Text field
  • Example values: US, GB, CA, AU, NZ, etc.
  • What it does:
    • Used as a fallback country when the Mindbody client has no country on their address.
    • CRMConnect uses this default to determine which country code to add.
  • You can change this at any time to match the main country where you operate.

5. Typical scenarios

Scenario A – Client in the United States with country set in Mindbody

  • Mindbody:
    • Mobile phone: 3105551234
    • Country: United States
  • Settings:
    • Add CountryCode prefix to Phone: ON
    • ISO CountryCode: US (default)
  • Result in HubSpot:
    • Phone / Mobile phone: +13105551234
    • HubSpot displays: Valid, country recognized as United States

Scenario B – Client in the UK with country set in Mindbody

  • Mindbody:
    • Mobile phone: 07123 456789
    • Country: United Kingdom
  • Settings:
    • Add CountryCode prefix to Phone: ON
    • ISO CountryCode: US
  • Result in HubSpot:
    • Phone / Mobile phone: +447123456789
    • HubSpot displays: Valid, country recognized as United Kingdom
      (Mindbody’s actual country overrides your default.)

Scenario C – Client with no country in Mindbody

  • Mindbody:
    • Mobile phone: 0400 000 000
    • Country: (empty)
  • Settings:
    • Add CountryCode prefix to Phone: ON
    • ISO CountryCode: AU
  • Result in HubSpot:
    • Phone / Mobile phone: +61400000000
    • HubSpot displays: Valid, country recognized as Australia

Scenario D – You prefer local numbers only

  • Mindbody:
    • Mobile phone: 3105551234
  • Settings:
    • Add CountryCode prefix to Phone: OFF
  • Result in HubSpot:
    • Phone / Mobile phone: 3105551234
    • HubSpot uses its own validation (may show “wrong format”/unrecognized country).

6. How to enable and configure the feature (step‑by‑step)

  1. Confirm you’re on v3.6 or later
    • This feature is part of the CRMConnect (Mindbody → HubSpot) v3.6 release.
    • If you’re not sure which version you’re on, contact APIANT or your implementation partner/support.
  2. Open CRMConnect settings
    • Log into your CRMConnect portal.
    • Go to your Mindbody <-> HubSpot CRMConnect product.
    • Open its Settings.
  3. Locate the HubSpot settings section
    • Find the section labeled HubSpot settings (or similar).
  4. Turn on international formatting
    • Set Add CountryCode prefix to Phone to ON.
    • Click Save.
  5. Set your default ISO country
    • In ISO CountryCode, enter your main country code (e.g. US, GB, CA, AU).
    • Click Save again if you changed it.
  6. Test with a client record
    • In Mindbody, open a test client:
      • Make sure they have a mobile phone and a country on their address (to test the preferred path).
      • Save the client to trigger an update.
    • In HubSpot, open the matching contact:
      • Confirm that Phone and Mobile phone show the international number (+<country code>...) and are marked as valid.

7. FAQs

Q1. Does this change existing phone numbers already in HubSpot?

Not automatically. The new behavior applies when:

  • A contact is created in HubSpot by CRMConnect, or
  • A contact is updated due to a new event from Mindbody (e.g. profile update, visit, purchase, etc., depending on your CRMConnect configuration).

If you want to normalize all existing numbers, you can:

  • Trigger updates from Mindbody (e.g. via a resync process), or
  • Contact APIANT / your implementation partner to discuss bulk update options.

Q2. Which HubSpot fields are affected?

By default, CRMConnect v3.6 writes the formatted number to:

  • Phone
  • Mobile phone

If you have custom mappings or custom fields, your implementation may vary—ask your integrator or APIANT support.

Q3. What if our business works with multiple countries?

The feature is designed for that:

  • If a client’s country is set in Mindbody, that country will be used to format the phone number—regardless of your default ISO CountryCode.
  • The ISO CountryCode setting only applies when Mindbody has no country for that client.

This makes CRMConnect flexible enough for studios/brands that serve multiple countries from the same HubSpot portal, while still giving you a sensible default for incomplete Mindbody data.

Q4. What happens if my ISO CountryCode value is invalid?

If you enter a value that is not a valid ISO 2‑letter code, phone formatting may fail or not behave as expected. Use standard ISO country codes (e.g. US, GB, CA, DE, FR).

If you’re unsure, contact APIANT support or your partner to confirm the correct setting.

Q5. Do I need to change anything in my automations?

No. The enhancement is built directly into the CRMConnect product logic as part of v3.6. Once your instance has been upgraded and you enable the setting, it will automatically apply to the relevant sync operations. This is the same “productized” approach used across all CRMConnect API Apps.

8. Troubleshooting checklist

If numbers are not appearing as expected in HubSpot, check:

  1. Is “Add CountryCode prefix to Phone” turned ON?
    • If not, turn it on, save, and run a new test.
  2. Does the Mindbody client have a country set?
    • If yes, ensure it’s correct and spelled properly (e.g. “United States”).
    • If no, verify that your ISO CountryCode default matches the country you expect.
  3. Is the mobile phone valid in Mindbody?
    • Remove non‑numeric characters that might cause issues (extensions, text notes, etc.).
  4. Has the contact actually been updated since v3.6 was enabled?
    • Make a small change in Mindbody (e.g. add a note) and save to trigger a fresh sync.
  5. Still stuck?
    • Contact APIANT support with:
      • Example Mindbody client name
      • Their Mindbody ID
      • The HubSpot contact URL
      • A screenshot of your CRMConnect HubSpot settings

If you’d like help reviewing your configuration or planning a data clean‑up using this new feature, your APIANT partner or support team can guide you through best practices for your specific account setup.