Mindbody API

Type safe library for interacting with Mindbody's Public API (v6) and Webhooks

⚠️ Read before installing
This library is typed according to the definitions available in Minbody's API docs. Their API fails to establish consistent patterns and field type definitons. An ID may be typed as a string or number and commonly swaps to a different type depending on the endpoint. Schema definitions are sometimes incomplete or completely wrong. Schema fields and endpoint paramters are only sometimes marked as nullable / optional. Please keep all this in mind (and body) when using this library. We uses this library internally in production (heavily) and we will correct / expand type definitions as we run accross issues. BUT, we do not interact with 100% of Mindbody's API. Please submit an issue or PR if you find an issue or would like to expand a type definition (ex. make a field nullable or query param / payload param optional)

The package includes all endpoints added before or during the September 2022 release and we are running MindBody v6 late 2023/early 2024.

PRs are welcome in any case.

https://developers.mindbodyonline.com/Resources/ApiReleaseNotes

Requirements

Bun 1.0.4 or higher.

Installation

Install the package with:

bun add axios https://github.com/vinyll/mindbody-api

Usage

Mindbody requires an API key to interact with endpoints and may additionally require a token generated from your staff credentials. Actions such as adding clients to a class require a user token included in the request headers. Tokens may only be generated for locations that have explicitly granted you permission. Some endpoints may limit the data returned if no token is provided.

https://developers.mindbodyonline.com/

import { Config } from 'mindbody-api'
Config.setup({ apiKey: '' })

or

import { Config } from 'mindbody-api'
Config.setup({
  apiKey: '',
  username: '',
  password: '',
})

Example

Endpoints are logically separated based on the categories listed here.

import { Class, Client, Staff, Webhooks } from 'mindbody-api'

const classes = await Class.getClassSchedules({
  siteID: '123',
  params: {
    StartDate: '2022-01-01',
    LocationIds: [1, 2],
  },
})

const newClient = await Client.addClient({
  siteID: '123',
  payload: { ... }
})

/**
 * Endpoints with optional parameters
 * or payloads may exclude the field
 */
const staff = await Staff.getStaff({
  siteID: '123',
  // Automatically page through all results.
  // Only applicable for paginated endpoints
  autoPaginate: true,
})

/**
 * Interact with Webhooks API
 *
 * https://developers.mindbodyonline.com/WebhooksDocumentation
 */
await Webhooks.Subscriptions.createSubscription({ ... })

Types

All model definitions are exported under MBType. A full list of models can be found here. Additional models were added for easy access to complex types not listed in Mindbody's documentation

import type { MBType, MBWebhookType } from 'mindbody-api'

const staff: MBType.Staff = ...
const client: MBType.Client = ...
// Webhook event types
const newClient: MBWebhookType.ClientCreated = ...

Todo

• Default SiteId in the global config
• [] Replace axios() with native fetch() to clear off dependencies.