REST API reference

Momence API

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
Momence
Momence 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

read

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

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

Parameters: list_classes
NameTypeDescription
from date First day. Default: today.
to date Last day. Default: 7 days from today.
teacher string Only classes taught by this teacher.
include_cancelled boolean Also return cancelled classes. Default: false.

Request

cURL
curl -X POST https://cotlet.dev/api/v1/momence/list_classes \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("momence", "list_classes")
Node.js
const result = await cotlet.call('momence', 'list_classes');
CLI
cotlet call momence list_classes

Example response

{
  "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

read

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

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

Parameters: get_class_roster
NameTypeDescription
class_id required string Class (session) ID from list_classes.

Request

cURL
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
result = client.call("momence", "get_class_roster", {"class_id":"class_8c41d2"})
Node.js
const result = await cotlet.call('momence', 'get_class_roster', {"class_id":"class_8c41d2"});
CLI
cotlet call momence get_class_roster --data '{"class_id":"class_8c41d2"}'

Example response

{
  "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

read

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

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

Parameters: search_customers
NameTypeDescription
query string Name, email or phone.
tag string Only customers with this tag.
limit integer 1 to 100. Default: 25.

Request

cURL
curl -X POST https://cotlet.dev/api/v1/momence/search_customers \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("momence", "search_customers")
Node.js
const result = await cotlet.call('momence', 'search_customers');
CLI
cotlet call momence search_customers

Example response

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

Get customer

read

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

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

Parameters: get_customer
NameTypeDescription
customer_id required string Customer ID from search_customers.

Request

cURL
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
result = client.call("momence", "get_customer", {"customer_id":"customer_8c41d2"})
Node.js
const result = await cotlet.call('momence', 'get_customer', {"customer_id":"customer_8c41d2"});
CLI
cotlet call momence get_customer --data '{"customer_id":"customer_8c41d2"}'

Example response

{
  "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

read

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

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

Parameters

Parameters: list_customer_payments
NameTypeDescription
customer_id required string Customer ID from search_customers.
since date Only payments on or after this date.

Request

cURL
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
result = client.call("momence", "list_customer_payments", {"customer_id":"customer_8c41d2"})
Node.js
const result = await cotlet.call('momence', 'list_customer_payments', {"customer_id":"customer_8c41d2"});
CLI
cotlet call momence list_customer_payments --data '{"customer_id":"customer_8c41d2"}'

Example response

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

Create class

write

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

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

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

Request

cURL
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
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
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
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

{
  "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

write Confirm

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

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

Parameters: cancel_class
NameTypeDescription
class_id required string Class (session) ID from list_classes.
note string Optional note added to the cancellation email.

Request

cURL
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
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
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
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

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

Book customer

write Confirm

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

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

Parameters: book_customer
NameTypeDescription
class_id required string Class (session) ID from list_classes.
customer_id required string Customer ID from search_customers.
waitlist boolean Add to the waitlist instead of booking. Default: false.

Request

cURL
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
result = client.call("momence", "book_customer", {"class_id":"class_8c41d2","customer_id":"customer_8c41d2"})
Node.js
const result = await cotlet.call('momence', 'book_customer', {"class_id":"class_8c41d2","customer_id":"customer_8c41d2"});
CLI
cotlet call momence book_customer --data '{"class_id":"class_8c41d2","customer_id":"customer_8c41d2"}'

Example response

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

Cancel booking

write Confirm

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

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

Parameters: cancel_booking
NameTypeDescription
booking_id required string Booking ID from get_class_roster.
credit_customer boolean Return the class credit to the customer.
notify_customer boolean Send the customer a cancellation notice.
late_cancel boolean Mark it as a late cancellation.

Request

cURL
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
result = client.call("momence", "cancel_booking", {"booking_id":"booking_8c41d2"})
Node.js
const result = await cotlet.call('momence', 'cancel_booking', {"booking_id":"booking_8c41d2"});
CLI
cotlet call momence cancel_booking --data '{"booking_id":"booking_8c41d2"}'

Example response

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

Check in customer

write

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

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

Parameters: check_in_customer
NameTypeDescription
booking_id required string Booking ID from get_class_roster.
checked_in boolean false undoes the check-in. Default: true.

Request

cURL
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
result = client.call("momence", "check_in_customer", {"booking_id":"booking_8c41d2"})
Node.js
const result = await cotlet.call('momence', 'check_in_customer', {"booking_id":"booking_8c41d2"});
CLI
cotlet call momence check_in_customer --data '{"booking_id":"booking_8c41d2"}'

Example response

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

Freeze membership

write Confirm

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

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

Parameters: freeze_membership
NameTypeDescription
membership_id required string Membership (subscription) ID from get_customer.
freeze_from date Start of the freeze. Default: now.
unfreeze_on date Scheduled unfreeze date.

Request

cURL
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
result = client.call("momence", "freeze_membership", {"membership_id":"sub_77120","freeze_from":"2026-11-01","unfreeze_on":"2026-11-30"})
Node.js
const result = await cotlet.call('momence', 'freeze_membership', {"membership_id":"sub_77120","freeze_from":"2026-11-01","unfreeze_on":"2026-11-30"});
CLI
cotlet call momence freeze_membership --data '{"membership_id":"sub_77120","freeze_from":"2026-11-01","unfreeze_on":"2026-11-30"}'

Example response

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

Cancel membership renewal

write Confirm

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

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

Parameters: cancel_membership_renewal
NameTypeDescription
membership_id required string Membership (subscription) ID from get_customer.
cancel_at datetime Scheduled cancellation. Default: now.

Request

cURL
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
result = client.call("momence", "cancel_membership_renewal", {"membership_id":"membership_8c41d2"})
Node.js
const result = await cotlet.call('momence', 'cancel_membership_renewal', {"membership_id":"membership_8c41d2"});
CLI
cotlet call momence cancel_membership_renewal --data '{"membership_id":"membership_8c41d2"}'

Example response

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

Send message

write Confirm

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

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

Parameters: send_message
NameTypeDescription
customer_ids required string[] Customer IDs from search_customers or get_class_roster.
channel required enum email, sms or in_app.
body required string Message text.
subject string Email subject. Email only.

Request

cURL
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
result = client.call("momence", "send_message", {"customer_ids":["customer ids"],"channel":"email","body":"body"})
Node.js
const result = await cotlet.call('momence', 'send_message', {"customer_ids":["customer ids"],"channel":"email","body":"body"});
CLI
cotlet call momence send_message --data '{"customer_ids":["customer ids"],"channel":"email","body":"body"}'

Example response

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

Refund payment

write Confirm

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

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

Parameters: refund_payment
NameTypeDescription
payment_id required string Payment ID from list_customer_payments.
refund_to required enum money or credits.

Request

cURL
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
result = client.call("momence", "refund_payment", {"payment_id":"payment_8c41d2","refund_to":"money"})
Node.js
const result = await cotlet.call('momence', 'refund_payment', {"payment_id":"payment_8c41d2","refund_to":"money"});
CLI
cotlet call momence refund_payment --data '{"payment_id":"payment_8c41d2","refund_to":"money"}'

Example response

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