---
title: CRMConnect v3.6 – International Phone Number Formatting (Mindbody → HubSpot)
description: 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.
---

[Skip to content](https://help.apiant.com/crmconnect-v3.6-international-phone-number-formatting-mindbody-hubspot#main-content)

English

Show submenu for translations

![apiant-logo-forum.png\]](https://help.apiant.com/hs-fs/hubfs/apiant-logo-forum.png?height=40&name=apiant-logo-forum.png)

Open main navigation

Close main navigation

- English
  
  Show submenu for translations
- Go to apiant.com

 Go to apiant.com

 Hello. How can we help you?

- There are no suggestions because the search field is empty.

1. [Help Center](https://help.apiant.com/?hsLang=en)
2. [CRMConnect](https://help.apiant.com/crmconnect?hsLang=en)
3. [Mindbody to HubSpot](https://help.apiant.com/crmconnect?hsLang=en#mindbody-to-hubspot)

# 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.

- [ZoomConnect](https://help.apiant.com/zoomconnect?hsLang=en)
- [ShopConnect](https://help.apiant.com/shopconnect?hsLang=en)
- [AppConnect](https://help.apiant.com/appconnect?hsLang=en#main-content)

    - [AppConnectPrebuiltConnectors](https://help.apiant.com/appconnect?hsLang=en#appconnectprebuiltconnectors)
- [CalendarConnect](https://help.apiant.com/calendarconnect?hsLang=en)
- [CRMConnect](https://help.apiant.com/crmconnect?hsLang=en#main-content)

    - [Mindbody to HubSpot](https://help.apiant.com/crmconnect?hsLang=en#mindbody-to-hubspot)
    - [Cliniko to HubSpot](https://help.apiant.com/crmconnect?hsLang=en#cliniko-to-hubspot)
    - [Cliniko to ActiveCampaign](https://help.apiant.com/crmconnect?hsLang=en#cliniko-to-activecampaign)
    - [DonorPerfect to HubSpot](https://help.apiant.com/crmconnect?hsLang=en#donorperfect-to-hubspot)
    - [DonorPerfect to ActiveCampaign](https://help.apiant.com/crmconnect?hsLang=en#donorperfect-to-activecampaign)
    - [Mindbody to ActiveCampaign](https://help.apiant.com/crmconnect?hsLang=en#mindbody-to-activecampaign)
- [MailConnect](https://help.apiant.com/mailconnect?hsLang=en)
- [AutomationEditor](https://help.apiant.com/automationeditor?hsLang=en#main-content)

    - [KeyConcepts](https://help.apiant.com/automationeditor?hsLang=en#keyconcepts)
    - [AccountManagement](https://help.apiant.com/automationeditor?hsLang=en#accountmanagement)
    - [ManagingAutomations](https://help.apiant.com/automationeditor?hsLang=en#managingautomations)
    - [App Connections](https://help.apiant.com/automationeditor?hsLang=en#app-connections)
    - [Building Automations](https://help.apiant.com/automationeditor?hsLang=en#building-automations)
- [APIANTforBuilders](https://help.apiant.com/apiantforbuilders?hsLang=en)
- [APIANTInline](https://help.apiant.com/apiantinline?hsLang=en)
- [WhatisAPIANT?](https://help.apiant.com/whatisapiant?hsLang=en)
- [ContactAPIANTsupport](https://help.apiant.com/contactapiantsupport?hsLang=en)

[![APIANT](https://help.apiant.com/hubfs/APIANT_LOGO-2.svg "APIANT")](http://apiant.com)

apiant.com Help Center

Copyright © 2026, APIANT