# Momence API

> Every Momence endpoint on Cotlet: inputs, JSON Schema, cURL, Python and Node.js examples and an example response for each call.

Source: https://cotlet.dev/docs/api/momence

Docs sections: [Get started](https://cotlet.dev/docs.md) · [REST API](https://cotlet.dev/docs/api.md) · [MCP](https://cotlet.dev/docs/mcp.md) · [SDKs & CLI](https://cotlet.dev/docs/sdks.md) · [Integrations](https://cotlet.dev/docs/integrations.md)

14 endpoints for Momence. Each one is a POST with a JSON body, called with your API key.

- Base URL: `https://cotlet.dev/api/v1/momence`
- Connects with: Your Momence staff account (permissions for classes, freezes, refunds and the Inbox decide what works)
- Integration page: https://cotlet.dev/integrations/momence-api-mcp-server

## Endpoints

| Endpoint | Access | Description |
|---|---|---|
| `list_classes` | read | Scheduled classes in a date range, with teacher, location, bookings and status. |
| `get_class_roster` | read | Customers booked into a class and on its waitlist, with check-in status. |
| `search_customers` | read | Find customers by name, email or phone, optionally by tag. |
| `get_customer` | read | Profile, tags, notes, active subscriptions and packs, and upcoming bookings. |
| `list_customer_payments` | read | Payments from the customer profile (Activity > Payments), newest first. |
| `create_class` | write | One-off class or recurring series from a class template, like Classes > Schedule > New Class. |
| `cancel_class` | write | Cancel one class. It stays on the customer schedule marked as cancelled. |
| `book_customer` | write | Book a customer into a class, or add them to its waitlist. |
| `cancel_booking` | write | Cancel a customer's booking in a class, with credit and notification choices. |
| `check_in_customer` | write | Mark a booking as checked in, or undo the check-in. |
| `freeze_membership` | write | Freeze a customer's subscription now or on a date, with an optional unfreeze date. |
| `cancel_membership_renewal` | write | Cancel Renewal on a subscription now or at a scheduled date, so it expires instead of charging again. |
| `send_message` | write | Message customers from the Momence Inbox by email, SMS or in-app message. |
| `refund_payment` | write | Refund a payment as money or as Momence credits; the original purchase stays on record. |

## List classes

`POST https://cotlet.dev/api/v1/momence/list_classes`

Access: read.

Returns classes between two dates in start order, with teacher, location, booked count and whether the class is cancelled. Cancelled classes are hidden unless include_cancelled is true. Use class_id from each item in get_class_roster and the write tools.

### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `from` | date | no | First day. Default: today. |
| `to` | date | no | Last day. Default: 7 days from today. |
| `teacher` | string | no | Only classes taught by this teacher. |
| `include_cancelled` | boolean | no | Also return cancelled classes. Default: false. |

### Request

**cURL**

```bash
curl -X POST https://cotlet.dev/api/v1/momence/list_classes \
  -H "Authorization: Bearer $COTLET_API_KEY"
```

**Python**

```python
result = client.call("momence", "list_classes")
```

**Node.js**

```js
const result = await cotlet.call('momence', 'list_classes');
```

**CLI**

```bash
cotlet call momence list_classes
```

### Example response

```json
{
  "classes": [
    {
      "class_id": "9182736",
      "name": "Vinyasa Flow 60",
      "starts_at": "2026-10-15T19:00:00-07:00",
      "teacher": "Maya Lee",
      "location": "Studio A",
      "booked": 14,
      "capacity": 18,
      "status": "scheduled"
    }
  ]
}
```

## Get class roster

`POST https://cotlet.dev/api/v1/momence/get_class_roster`

Access: read.

Returns booked customers and the waitlist for one class. Each booking has a booking_id for check_in_customer and cancel_booking, and its check-in status. Waitlisted customers have no booking_id.

### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `class_id` | string | yes | Class (session) ID from list_classes. |

### Request

**cURL**

```bash
curl -X POST https://cotlet.dev/api/v1/momence/get_class_roster \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"class_id":"class_8c41d2"}'
```

**Python**

```python
result = client.call("momence", "get_class_roster", {"class_id":"class_8c41d2"})
```

**Node.js**

```js
const result = await cotlet.call('momence', 'get_class_roster', {"class_id":"class_8c41d2"});
```

**CLI**

```bash
cotlet call momence get_class_roster --data '{"class_id":"class_8c41d2"}'
```

### Example response

```json
{
  "class_id": "9182736",
  "bookings": [
    {
      "booking_id": "bk_204118",
      "customer_id": "cu_5521",
      "name": "Sam Rivera",
      "checked_in": false
    },
    {
      "booking_id": "bk_204119",
      "customer_id": "cu_5530",
      "name": "Jordan Pike",
      "checked_in": true
    }
  ],
  "waitlist": [
    {
      "customer_id": "cu_5544",
      "name": "Alex Moreau"
    }
  ]
}
```

## Search customers

`POST https://cotlet.dev/api/v1/momence/search_customers`

Access: read.

Returns matching customers with ID, name, email and tags. Use customer_id in get_customer, book_customer and list_customer_payments. Tags are the ones you set in Momence.

### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `query` | string | no | Name, email or phone. |
| `tag` | string | no | Only customers with this tag. |
| `limit` | integer | no | 1 to 100. Default: 25. |

### Request

**cURL**

```bash
curl -X POST https://cotlet.dev/api/v1/momence/search_customers \
  -H "Authorization: Bearer $COTLET_API_KEY"
```

**Python**

```python
result = client.call("momence", "search_customers")
```

**Node.js**

```js
const result = await cotlet.call('momence', 'search_customers');
```

**CLI**

```bash
cotlet call momence search_customers
```

### Example response

```json
{
  "customers": [
    {
      "customer_id": "cu_5530",
      "name": "Jordan Pike",
      "email": "jordan@example.com",
      "tags": [
        "teacher-training"
      ]
    }
  ]
}
```

## Get customer

`POST https://cotlet.dev/api/v1/momence/get_customer`

Access: read.

Returns one customer profile with notes, active subscriptions and packs, and upcoming bookings. Subscription IDs from here go into freeze_membership and cancel_membership_renewal.

### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `customer_id` | string | yes | Customer ID from search_customers. |

### Request

**cURL**

```bash
curl -X POST https://cotlet.dev/api/v1/momence/get_customer \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"customer_id":"customer_8c41d2"}'
```

**Python**

```python
result = client.call("momence", "get_customer", {"customer_id":"customer_8c41d2"})
```

**Node.js**

```js
const result = await cotlet.call('momence', 'get_customer', {"customer_id":"customer_8c41d2"});
```

**CLI**

```bash
cotlet call momence get_customer --data '{"customer_id":"customer_8c41d2"}'
```

### Example response

```json
{
  "customer_id": "cu_5530",
  "name": "Jordan Pike",
  "email": "jordan@example.com",
  "tags": [
    "teacher-training"
  ],
  "notes": [
    "Prefers the back row."
  ],
  "memberships": [
    {
      "membership_id": "sub_77120",
      "name": "Unlimited Monthly",
      "status": "active",
      "renews_on": "2026-11-05"
    }
  ],
  "upcoming_bookings": [
    {
      "booking_id": "bk_204119",
      "class_id": "9182736",
      "starts_at": "2026-10-15T19:00:00-07:00"
    }
  ]
}
```

## List customer payments

`POST https://cotlet.dev/api/v1/momence/list_customer_payments`

Access: read.

Returns the payments listed under Activity > Payments on the customer profile, newest first. Use payment_id in refund_payment.

### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `customer_id` | string | yes | Customer ID from search_customers. |
| `since` | date | no | Only payments on or after this date. |

### Request

**cURL**

```bash
curl -X POST https://cotlet.dev/api/v1/momence/list_customer_payments \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"customer_id":"customer_8c41d2"}'
```

**Python**

```python
result = client.call("momence", "list_customer_payments", {"customer_id":"customer_8c41d2"})
```

**Node.js**

```js
const result = await cotlet.call('momence', 'list_customer_payments', {"customer_id":"customer_8c41d2"});
```

**CLI**

```bash
cotlet call momence list_customer_payments --data '{"customer_id":"customer_8c41d2"}'
```

### Example response

```json
{
  "payments": [
    {
      "payment_id": "pay_330917",
      "date": "2026-10-04",
      "description": "Drop-in: Vinyasa Flow 60",
      "amount": 25,
      "currency": "USD",
      "refunded": false
    }
  ]
}
```

## Create class

`POST https://cotlet.dev/api/v1/momence/create_class`

Access: write.

Creates one class, or a series when repeat_every_days is set, from an existing class template. Returns the new class IDs and the first dates. With as_draft the classes stay hidden from customers. It reaches no one until published and is undone with cancel_class, so it runs without asking.

### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `template` | string | yes | Class template name; holds the class name and description. |
| `teacher` | string | yes | Teacher name. |
| `location` | string | yes | Location name, in person or online. |
| `starts_at` | datetime | yes | First class, ISO 8601 with time zone. |
| `duration_minutes` | integer | yes | Length of each class. |
| `repeat_every_days` | integer | no | Days between classes for a recurring series, e.g. 7. Omit for a one-off class. |
| `end_date` | date | no | Last date of the series. Without it the series keeps scheduling itself. |
| `as_draft` | boolean | no | Save unpublished, hidden from customers. Default: false. |

### Request

**cURL**

```bash
curl -X POST https://cotlet.dev/api/v1/momence/create_class \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"template":"Vinyasa Flow 60","teacher":"Maya Lee","location":"Studio A","starts_at":"2026-10-15T19:00:00-07:00","duration_minutes":60,"repeat_every_days":7,"end_date":"2026-12-31"}'
```

**Python**

```python
result = client.call("momence", "create_class", {"template":"Vinyasa Flow 60","teacher":"Maya Lee","location":"Studio A","starts_at":"2026-10-15T19:00:00-07:00","duration_minutes":60,"repeat_every_days":7,"end_date":"2026-12-31"})
```

**Node.js**

```js
const result = await cotlet.call('momence', 'create_class', {"template":"Vinyasa Flow 60","teacher":"Maya Lee","location":"Studio A","starts_at":"2026-10-15T19:00:00-07:00","duration_minutes":60,"repeat_every_days":7,"end_date":"2026-12-31"});
```

**CLI**

```bash
cotlet call momence create_class --data '{"template":"Vinyasa Flow 60","teacher":"Maya Lee","location":"Studio A","starts_at":"2026-10-15T19:00:00-07:00","duration_minutes":60,"repeat_every_days":7,"end_date":"2026-12-31"}'
```

### Example response

```json
{
  "series_id": "ser_48213",
  "classes_created": 12,
  "first_class_id": "9182736",
  "status": "published",
  "next_classes": [
    "2026-10-15T19:00:00-07:00",
    "2026-10-22T19:00:00-07:00"
  ]
}
```

## Cancel class

`POST https://cotlet.dev/api/v1/momence/cancel_class`

Access: write. Confirm: waits for the user's OK before it runs.

Cancels one class. It stays on the schedule marked as cancelled, and Momence emails every registered customer its cancellation template, with your optional note in it. Returns how many customers were notified. By default you confirm each call; you can switch that off for this tool.

### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `class_id` | string | yes | Class (session) ID from list_classes. |
| `note` | string | no | Optional note added to the cancellation email. |

### Request

**cURL**

```bash
curl -X POST https://cotlet.dev/api/v1/momence/cancel_class \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"class_id":"9182736","note":"Maya is unwell today. Your credit is back on your account, and the 9am Vinyasa has spots."}'
```

**Python**

```python
result = client.call("momence", "cancel_class", {"class_id":"9182736","note":"Maya is unwell today. Your credit is back on your account, and the 9am Vinyasa has spots."})
```

**Node.js**

```js
const result = await cotlet.call('momence', 'cancel_class', {"class_id":"9182736","note":"Maya is unwell today. Your credit is back on your account, and the 9am Vinyasa has spots."});
```

**CLI**

```bash
cotlet call momence cancel_class --data '{"class_id":"9182736","note":"Maya is unwell today. Your credit is back on your account, and the 9am Vinyasa has spots."}'
```

### Example response

```json
{
  "class_id": "9182736",
  "status": "cancelled",
  "customers_notified": 14
}
```

## Book customer

`POST https://cotlet.dev/api/v1/momence/book_customer`

Access: write. Confirm: waits for the user's OK before it runs.

Adds a customer to a class, or to its waitlist when waitlist is true. Returns the booking_id, or the waitlist position. The customer gets Momence's usual booking notice. By default you confirm each call; you can switch that off for this tool.

### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `class_id` | string | yes | Class (session) ID from list_classes. |
| `customer_id` | string | yes | Customer ID from search_customers. |
| `waitlist` | boolean | no | Add to the waitlist instead of booking. Default: false. |

### Request

**cURL**

```bash
curl -X POST https://cotlet.dev/api/v1/momence/book_customer \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"class_id":"class_8c41d2","customer_id":"customer_8c41d2"}'
```

**Python**

```python
result = client.call("momence", "book_customer", {"class_id":"class_8c41d2","customer_id":"customer_8c41d2"})
```

**Node.js**

```js
const result = await cotlet.call('momence', 'book_customer', {"class_id":"class_8c41d2","customer_id":"customer_8c41d2"});
```

**CLI**

```bash
cotlet call momence book_customer --data '{"class_id":"class_8c41d2","customer_id":"customer_8c41d2"}'
```

### Example response

```json
{
  "class_id": "9182736",
  "customer_id": "cu_5544",
  "status": "booked",
  "booking_id": "bk_204130"
}
```

## Cancel booking

`POST https://cotlet.dev/api/v1/momence/cancel_booking`

Access: write. Confirm: waits for the user's OK before it runs.

Cancels one customer's booking, the same as Cancel booking next to the customer in the class. You choose whether to credit the customer, whether to notify them and whether it counts as a late cancellation. Late-cancellation charges follow your Cancellation Policy setting. By default you confirm each call; you can switch that off for this tool.

### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `booking_id` | string | yes | Booking ID from get_class_roster. |
| `credit_customer` | boolean | no | Return the class credit to the customer. |
| `notify_customer` | boolean | no | Send the customer a cancellation notice. |
| `late_cancel` | boolean | no | Mark it as a late cancellation. |

### Request

**cURL**

```bash
curl -X POST https://cotlet.dev/api/v1/momence/cancel_booking \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"booking_id":"booking_8c41d2"}'
```

**Python**

```python
result = client.call("momence", "cancel_booking", {"booking_id":"booking_8c41d2"})
```

**Node.js**

```js
const result = await cotlet.call('momence', 'cancel_booking', {"booking_id":"booking_8c41d2"});
```

**CLI**

```bash
cotlet call momence cancel_booking --data '{"booking_id":"booking_8c41d2"}'
```

### Example response

```json
{
  "booking_id": "bk_204118",
  "status": "cancelled",
  "credited": true,
  "notified": true,
  "late_cancel": false
}
```

## Check in customer

`POST https://cotlet.dev/api/v1/momence/check_in_customer`

Access: write.

Marks one booking as checked in, or not checked in when checked_in is false. It reaches no one and is undone in one call, so it runs without asking.

### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `booking_id` | string | yes | Booking ID from get_class_roster. |
| `checked_in` | boolean | no | false undoes the check-in. Default: true. |

### Request

**cURL**

```bash
curl -X POST https://cotlet.dev/api/v1/momence/check_in_customer \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"booking_id":"booking_8c41d2"}'
```

**Python**

```python
result = client.call("momence", "check_in_customer", {"booking_id":"booking_8c41d2"})
```

**Node.js**

```js
const result = await cotlet.call('momence', 'check_in_customer', {"booking_id":"booking_8c41d2"});
```

**CLI**

```bash
cotlet call momence check_in_customer --data '{"booking_id":"booking_8c41d2"}'
```

### Example response

```json
{
  "booking_id": "bk_204118",
  "checked_in": true
}
```

## Freeze membership

`POST https://cotlet.dev/api/v1/momence/freeze_membership`

Access: write. Confirm: waits for the user's OK before it runs.

Freezes a subscription now or from a date, and unfreezes it on unfreeze_on if set. Momence cancels all the customer's future bookings made with that subscription. The renewal date moves forward by the frozen days unless Preserve Payment Schedule is on. Needs a staff account allowed to freeze. By default you confirm each call; you can switch that off for this tool.

### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `membership_id` | string | yes | Membership (subscription) ID from get_customer. |
| `freeze_from` | date | no | Start of the freeze. Default: now. |
| `unfreeze_on` | date | no | Scheduled unfreeze date. |

### Request

**cURL**

```bash
curl -X POST https://cotlet.dev/api/v1/momence/freeze_membership \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"membership_id":"sub_77120","freeze_from":"2026-11-01","unfreeze_on":"2026-11-30"}'
```

**Python**

```python
result = client.call("momence", "freeze_membership", {"membership_id":"sub_77120","freeze_from":"2026-11-01","unfreeze_on":"2026-11-30"})
```

**Node.js**

```js
const result = await cotlet.call('momence', 'freeze_membership', {"membership_id":"sub_77120","freeze_from":"2026-11-01","unfreeze_on":"2026-11-30"});
```

**CLI**

```bash
cotlet call momence freeze_membership --data '{"membership_id":"sub_77120","freeze_from":"2026-11-01","unfreeze_on":"2026-11-30"}'
```

### Example response

```json
{
  "membership_id": "sub_77120",
  "status": "freeze_scheduled",
  "freeze_from": "2026-11-01",
  "unfreeze_on": "2026-11-30",
  "future_bookings_cancelled": 2
}
```

## Cancel membership renewal

`POST https://cotlet.dev/api/v1/momence/cancel_membership_renewal`

Access: write. Confirm: waits for the user's OK before it runs.

Stops a subscription from renewing now or at cancel_at. Some memberships need a minimum number of renewals first, and cancelling a main membership also cancels the renewals of its linked membership. By default you confirm each call; you can switch that off for this tool.

### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `membership_id` | string | yes | Membership (subscription) ID from get_customer. |
| `cancel_at` | datetime | no | Scheduled cancellation. Default: now. |

### Request

**cURL**

```bash
curl -X POST https://cotlet.dev/api/v1/momence/cancel_membership_renewal \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"membership_id":"membership_8c41d2"}'
```

**Python**

```python
result = client.call("momence", "cancel_membership_renewal", {"membership_id":"membership_8c41d2"})
```

**Node.js**

```js
const result = await cotlet.call('momence', 'cancel_membership_renewal', {"membership_id":"membership_8c41d2"});
```

**CLI**

```bash
cotlet call momence cancel_membership_renewal --data '{"membership_id":"membership_8c41d2"}'
```

### Example response

```json
{
  "membership_id": "sub_77120",
  "status": "renewal_cancelled",
  "cancels_at": "2026-11-05T00:00:00-08:00"
}
```

## Send message

`POST https://cotlet.dev/api/v1/momence/send_message`

Access: write. Confirm: waits for the user's OK before it runs.

Sends one message from Home > Inbox to one or more customers by email, SMS or in-app. A message to several customers does not reach those who unsubscribed; a one-to-one message does. Sending to 75 or more email recipients needs the Marketing Suite, and SMS is billed in segments. In-app messages show only if the customer enabled notifications. By default you confirm each call; you can switch that off for this tool.

### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `customer_ids` | string[] | yes | Customer IDs from search_customers or get_class_roster. |
| `channel` | enum | yes | email, sms or in_app. |
| `body` | string | yes | Message text. |
| `subject` | string | no | Email subject. Email only. |

### Request

**cURL**

```bash
curl -X POST https://cotlet.dev/api/v1/momence/send_message \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"customer_ids":["customer ids"],"channel":"email","body":"body"}'
```

**Python**

```python
result = client.call("momence", "send_message", {"customer_ids":["customer ids"],"channel":"email","body":"body"})
```

**Node.js**

```js
const result = await cotlet.call('momence', 'send_message', {"customer_ids":["customer ids"],"channel":"email","body":"body"});
```

**CLI**

```bash
cotlet call momence send_message --data '{"customer_ids":["customer ids"],"channel":"email","body":"body"}'
```

### Example response

```json
{
  "channel": "sms",
  "recipients": 14,
  "delivered_to_provider": 14,
  "skipped_unsubscribed": 0
}
```

## Refund payment

`POST https://cotlet.dev/api/v1/momence/refund_payment`

Access: write. Confirm: waits for the user's OK before it runs.

Refunds one payment from the customer profile, as money back to the card or as Momence credits. The original purchase stays on record with a separate refund entry. Needs a staff account allowed to refund. By default you confirm each call; you can switch that off for this tool.

### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `payment_id` | string | yes | Payment ID from list_customer_payments. |
| `refund_to` | enum | yes | money or credits. |

### Request

**cURL**

```bash
curl -X POST https://cotlet.dev/api/v1/momence/refund_payment \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"payment_id":"payment_8c41d2","refund_to":"money"}'
```

**Python**

```python
result = client.call("momence", "refund_payment", {"payment_id":"payment_8c41d2","refund_to":"money"})
```

**Node.js**

```js
const result = await cotlet.call('momence', 'refund_payment', {"payment_id":"payment_8c41d2","refund_to":"money"});
```

**CLI**

```bash
cotlet call momence refund_payment --data '{"payment_id":"payment_8c41d2","refund_to":"money"}'
```

### Example response

```json
{
  "payment_id": "pay_330917",
  "refunded_to": "credits",
  "amount": 25,
  "currency": "USD",
  "status": "refunded"
}
```