MZ Mindbody API


MZ Mindbody API uses the Devin Crossman API to interface with MindBodyOnline and display Staff, Schedule and Workshops.

Two important requirements are:

1. PEAR and SOAP must be installed/enabled on the web server
2. MindBodyOnline API Developer Account

(NO LONGER PHP 5.2 compliant!)

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


This is not a terribly easy plugin to install.
Configuring the server may require input from your web hosting company (or you might get lucky).
And getting all the MindBody details configured can also be a little laborious.
Also mindbody is charging developers $5 per month per account connection now.


  • Calendar Display
  • Details Modal
  • Teacher Bio Page
  • 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.


One of the elements I need to fill is 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.


Excellent Support

The plugin was exactly what I was looking for and the developers were very helpful in troubleshooting any problems. 5 Stars!

Great plugin and excellent support

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!

Great plugin

Thank you so much for building this! Really helps with a project I am working on with the Mindbody API

Read all 10 reviews

Contributors & Developers

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


Translate “MZ Mindbody API” into your language.

Interested in development?

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



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.