MZ Mindbody API


Display special events, class schedules and instructors from Mindbody.

Configurable with template over-rides in your theme.

Easy to extend, includes feature for displaying registrants.

Schedule display can be vertical or horizontal. User can switch between both.

Open Source on GitHub

Why am I getting “Permission denied” and “Invalid Argument” errors?

You need to register a developer account with MindBody, which costs $5+ per website. Follow the instructions at

নোট সমুহ

Now that we’re using Mindbody’s v6 api, this should be pretty easy to get going.


  • Horizontal Calendar Display
  • Grid Calendar Display
  • Details Modal
  • Staff Page Gallery
  • Staff Page Full
  • Admin Page


Steps to install and configure MZ Mindbody API:

  1. Upload the directory, mz_mindbody_api to the /wp-content/plugins/ directory
  2. Activate the plugin through the ‘Plugins’ menu in WordPress
  3. Follow instructions at
  4. In the WP Admin panel go to: Settings -> MZ Mindbody and configure settings
  5. This plugin includes some minimal CSS which you can override in theme.
  6. Also includes some bootstrap css and javascript so check there if conflicts arise.
  7. Read through the Settings > MZ Mindbody page for further instructions and options.


One of the elements I need to fill out are the *Event IDs*. Can you help me learn where to find those?

I’m not sure if there’s an easier way, but you can find them by, within MindBody,
going to an Event EDIT page and viewing the source of the Dropdown menu items, which
contain the name of each event type and it’s associated ID number.


ডিসেম্বর 20, 2017
It works great! Thanks for making this available.
নভেম্বর 17, 2016
The plugin was exactly what I was looking for and the developers were very helpful in troubleshooting any problems. 5 Stars!
নভেম্বর 10, 2016
This free plug-in does exactly what we need it to. Had some difficulty setting it up at first but the support was great. It would be nice to have the ability to display class pricing in future! Thanks!
সেপ্টেম্বর 3, 2016
Thank you so much for building this! Really helps with a project I am working on with the Mindbody API
সব রিভিউ পড়ুন

ডেভেলপার এবং কন্ট্রিবিউটর

“MZ Mindbody API” is open source software. The following people have contributed to this plugin.


Translate “MZ Mindbody API” into your language.

ডেভেলপমেন্ট এ আগ্রহী?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.



Add a helper function.


Bugfix: fix session_type shortcode attribute.
Bugfix: some debug logging
Remove Sessions and Client which are now in a child plugin.


Bugfix: fix php missing call to MZMBO to specify variable as class property.
Bugfix: Reinstate siteID used in signup links in class schedules.
Bugfix: Fix way cancelled classes handled.
Increase limit of items pulled from MBO from 100 to 200 (the max).


Utilize v6 of the MBO API with v5 left for legacy purposes.
Updated Credentials will be required.
Minimum php version of 7.0.
Swap out “loading” element with Bootstrap load.
Upgrade to Bootstrap v4.
Manage assets with Webpack instead of Bower.
Add support for MBO Access plugin.


Alert admin when API calls get close to 1000 and short circuit calls when past 2000.


Bugfix: fix php error displaying on schedule when MBO credentials bad.


Bugfix: fix event registration URL.


Bugfix: some registrations were pulling user data from previous class registration.


Bugfix: reinstate default timestamp in retrieve classes time_frame method.


Bugfix: url for class sign-up via MBO
Bugfix: add default checkbox values for a couple of admin settings


Fix/reinstate single day schedule display


Fix problem with deactivation method.
Fix issue with specifying locations in Events display
Fix issue with incorrect “default” listed in Admin page copy.
Add ability to filter events listing by location.


Fix path for Template override directory


Completely refactor the plugin with a more informed approach
Implement Gemajo templating class so users can overwrite shortcode templates
Implement Eric Mann’s WordPress session managment
Allow users to login and out, create accounts within same page as schedule/events
Separate plugin codebase from Docker dev env wrapper
Add try/except wrapper around SoapClient.
Add try/except wrapper around require Server.php.
Add unit test scaffolding
Add Autoload and namespacing
Add option to log MBO API calls


Add docker wrapper and phpunit test scaffolding.
Bug fix: missing (not yet used) dependency.


Bug Fix: Replace Global that wasn’t available.


Fix error where only single week of events displayed.


Fix break with events listing that occurred in last release.
Fix break in signup links also from recent updates.


Show full seven days in horizontal mode starting current day.
Remove date filter from javascript to php.


Remove Modernizr.
Add shortcode to display limited number of events.


Fix typo and add class.


Fix issue with events duration length display and enable modal window on events list.


  • New parameter for Events – “list=1” to display short list of events


  • Fix error with show_registrants which got broken in development


  • Fix bug with multiple locations requiring space between them in shortcode.
  • Use Object for Class Event to reduce code redundancy. (Dry it up)
  • Fix errors with transients


  • Fix error date_display not displaying with add to class.


  • Wrap $ calls in (function($) { //$ here })( jQuery );


  • Display schedule navigation even if there are no classes in current week.
  • Allow shortcode argument to hide cancelled classes from calendar: show_cancelled=1
  • Replace $(document).ready(function($) with jQuery(document).ready(function($)


  • Use OOP to create link for schedule pop-up.


  • Repair cache reset.


  • Build transient name dynamically based on shortcode atts and $_GET variable.


  • Fix error with timestamp in schedule.


  • Refactor to make Schedule script more DRY.
  • Replace Bootstrap Modal with colorbox which seems to be less likely to cause theme conflicts.
  • Fix broken caching.


  • Not much of note


  • Clean up and add a little output on SOAP ERROR.


  • Remove jquery version 2 so we stop breaking themes
  • Add shortcode option to display registrants for classes


  • I forget


  • Using bootstrap gallery to optionally display staff page as gallery
  • Hopefully adding the new CSS won’t cause theme conflicts.


  • Refactor with more OOP approach
  • Could be further refactored.
  • Fix error with events display


  • Can display multiple locations on same calendar with select to filter. Shortcode
  • to show calendar with specified class types.
  • Using modified version of jQuery.filterTable now.
  • Locations now held in array, but still supporting older single item method.
  • Add CSS classes to horizontal schedule display cells.


This release includes the most new features and also uses a more minimal version of bootstrap code:
just the necessary components. New jQuery filter, grid mode schedule view, configurable event cycle duration,
multiple accounts and locations can be shown also via shortcode attributes.
Internationalized – so far Spanish and Portuguese.


Fix some HTML validation errors in schedule table layout.


(Re-)integration of short code type=day for schedule page to show “today’s” classes.


Further navigation refactoring.


Refactor navigation and address conflict with older version of MB_API.


Fix navigation on Schedule page when Force Cache not selected.


Initial release.