In This Article:
- Mindbody's Mandatory API Change
- What Elements and Integrated Pages are affected by the change?
- What is a mindbody account?
- Why are existing clients prompted to make a new mindbody account?
- What to do if clients get an "A mindbody account with this email already exists" error.
- How do I check if a client's mindbody account is linked to their profile?
- How do I reset a client's mindbody account password?
- Where can clients manage their mindbody accounts?
- Why are clients missing account information, such as purchases or visits?
- Why are new mindbody accounts showing filler/placeholder content?
- Enabling Required Client Fields
- Where is the logo that appears in the new login pop-up coming from?
- Known Mindbody API Bugs
Mindbody's Mandatory API Change
On October 31, 2024, mindbody required all API integrations to validate account logins through their new Identity Service (also known as OAuth or Single Sign On). To comply with this mindbody requirement, the login experience has been modified within our integration to link clients out to mindbody's Identity Service. Once users log into their mindbody account, they will be redirected to your liveedit website and continue as normal.
What Elements and Integrated Pages are affected by the change?
Login Element and integrated page (/apps/mindbody/login)
Schedule Element and integrated page (/apps/mindbody/schedule)
Enrollment Element and integrated page (/apps/mindbody/enrollments)
Appointment Element and integrated page (/apps/mindbody/appointmentsv2)
Account Creation and Registration (Kiosk) Elements: Creating an account will function but will prompt users to create a new password upon logging in the first time
What is a mindbody account?
A mindbody account is a secure login that allows your clients to use a single username and password across the mindbody family of products and all other businesses that run on mindbody.
In the mindbody software, each of your clients has a profile that is unique to your business.
- Each account stores all the client information in one location within your site.
- This account is never shared with or transferred to another mindbody business.
- The username and password stored in the account is only used to sign in to your site.
A mindbody account is separate from the client’s profile information. It’s only linked to the client’s identity. This means:
- Your client's identity (i.e., first and last name, email address, password, and country) in the account is universal.
- The identity information can be transferred between businesses.
- The username and password can be used on all of mindbody's integrations.
The profile information at your business and the mindbody account are brought together by linking them to receive the client's universal identity. As a result of this link, new and existing clients can securely access multiple businesses and view all their purchases or bookings made through the applications in their profiles at that business.
To learn more, please see the following guides from mindbody:
- Client Info screen - Mindbody Account section
- mindbody account FAQ for businesses
- mindbody account FAQ for users
- Consumer Identity overview
- Consumer Identity FAQ
Why are existing clients prompted to make a new mindbody account?
When returning clients log in for the first time with their existing credentials at your business, they are prompted to create a new mindbody account if one does not exist with their email address. Once created and verified, their new mindbody account will link to their existing profile at your business. Clients will then use their new mindbody account credentials to log in moving forward.
Please Note: After creating and linking a mindbody account for the first time, it can take mindbody's system about 12 to 24 hours to sync the account data between them.
What to do if clients get an "A mindbody account with this email already exists" error.
This error appears when a client attempts to create a new account using an email address that is already associated with an existing mindbody account. Clients will need to link their mindbody accounts with your business. To learn more, please see the following mindbody guides:
- Why is my client getting an error that an account already exists?
- How to link your mindbody account to a studio profile
How do I check if a client's mindbody account is linked to their profile?
A linked mindbody account will appear under the "Client Info" tab of a client's profile at your business.
How do I reset a client's mindbody account password?
Please take a look at the mindbody's guide here: Can I reset a Mindbody account password?
Where can clients manage their mindbody accounts?
Clients can visit https://account.mindbodyonline.com to manage their mindbody account and see what business they are linked to.
Why are clients missing account information, such as purchases or visits?
Here are the common reasons for missing account data:
- After creating and linking a mindbody account for the first time, it takes mindbody's system about 12 to 24 hours to sync the account data between them.
- Duplicate profiles at your business under the same email address. Please use mindbody's duplicate tool to locate and merge duplicate accounts.
- Merge Duplicate Client's tool
- Note: It can take upwards of 24 hours to merge accounts in mindbody's system.
- Mindbody account is linked to an inactive profile. Please reactive the account or link the mindbody account to the active account.
- If an account was previously merged from a few years ago, it may have missing account information after logging in through the new mindbody Identity Service. Please reach out to mindbody’s support team if you have a client experiencing this issue and they can correct the account.
Why are new mindbody accounts showing filler/placeholder content?
When creating a brand new mindbody account, a profile unique to your business is automatically created upon login with placeholder information due to mindbody's API requirements. We recommend enabling the required client fields option to prompt users to fill out this information upon returning to your website to complete this information.
Enabling Required Client Fields
Creating a mindbody account through mindbody's Identity Service does not capture any required client fields unique to your business (How to set up client required fields) and will fill in default information. We have an optional feature to capture required fields after clients return to your liveedit website.
Please Note: The required field prompt will only appear during the booking process for classes, enrollments, or appointments. It won't be visible when purchasing products only. We're working on adding this as an option feature for product purchases.
To enable this option, please follow these steps:
- Log in as an admin to your liveedit website.
- Click on the Dashboard icon
- Click on the Mindbody app icon
- Click on Settings
- Click on the Sign Ups/Forms tab
- Check the Capture Required Profile Details After SSO Login option
- Click Save Signups Settings
Where is the logo that appears in the new login pop-up coming from?
The logo displayed is the Main Business Logo uploaded in your mindbody Business Mode settings.
Known Mindbody API Bugs
Mindbody has two known bugs with their API regarding the new login experience that they are working to resolve as soon as possible:
- Logging out redirects to the integrated mindbody checkout page (/apps/mindbody/checkout).
- If an account was previously merged a few years ago, it may have missing account information after logging in through the new mindbody Identity Service. Please reach out to mindbody’s support team if you have a client experiencing this issue and they can correct the account.