--- title: Momence API Integration on Truto slug: momence category: Scheduling canonical: "https://truto.one/integrations/detail/momence/" --- # Momence API Integration on Truto **Category:** Scheduling **Status:** Beta ## MCP-ready AI tools Truto exposes 73 tools for Momence that AI agents can call directly. - **list_all_momence_auth_authorizes** — Initiate the OAuth2 authorization code flow in Momence by redirecting the user to the authorize endpoint. The user sees a Momence login screen and, upon successful authentication, is redirected back to the provided redirect_uri with an authorization code. The returned response is a browser-facing HTML page or HTTP redirect, not a JSON body. - **create_a_momence_auth_token** — Obtain a new OAuth2 access token in Momence using the password, refresh_token, or authorization_code grant type. Returns: accessToken, access_token, accessTokenExpiresAt, refreshToken, refresh_token, refreshTokenExpiresAt. Additional fields (username/password, refresh_token, or code) are required depending on the chosen grant type; client credentials may be sent in the body… - **list_all_momence_auth_profiles** — Get the currently logged-in user's profile in Momence. Returns: userId, memberId, email, firstName, lastName. - **create_a_momence_auth_logout** — Invalidate the provided access token, ending the current Momence session. Returns an empty 201 response on success. No required parameters. - **list_all_momence_appointments_reservations** — List all appointment reservations in Momence with optional filtering by date range, cancellation status, and payment status. Returns: id, createdAt, cancelledAt, startsAt, endsAt, durationInMinutes, priceInCurrency, depositInCurrency, isDepositPaid, currency, isPaid, capacity, board, service, serviceVariant, teacher, additionalTeacher, isInPerson, inPersonLocation, onlineStreamUrl,… - **create_a_momence_checkout_compatible_membership** — Get bought memberships compatible with a specified member's checkout cart in Momence. Returns: items. Incompatible memberships are also returned with an incompatibility reason so you can display why a membership cannot be used. Required: memberId, items. - **create_a_momence_checkout_price** — Get checkout prices for a member's cart in Momence. Call this before the checkout endpoint to fetch correct prices for every item in the cart. Returns: items with per-item pricing data. Required: memberId, items, paymentMethods. - **create_a_momence_host_checkout** — Perform checkout in Momence, paying for cart items on behalf of a specified member. Returns: items (list of purchased items). Currently only supports buying sessions with membership payment; fetch correct prices from /prices and verify membership compatibility via /compatible-memberships before calling. Required: memberId, items, paymentMethods. - **list_all_momence_member_appointments** — List appointment reservations for a specific Momence member, with optional date-range and cancellation filters. Returns: id, createdAt, cancelledAt, startsAt, endsAt, durationInMinutes, priceInCurrency, depositInCurrency, isDepositPaid, currency, isPaid, capacity, board, service, serviceVariant, teacher, additionalTeacher, isInPerson, inPersonLocation, onlineStreamUrl, onlineStreamPassword,…. Required: member_id. - **list_all_momence_bought_memberships_actives** — List all active subscriptions and packs for a specific member in Momence. Returns: id, type, startDate, endDate, isFrozen, eventCreditsLeft, eventCreditsTotal, moneyCreditsLeft, moneyCreditsTotal, usageLimitForSessions, usageLimitForAppointments, combinedUsageLimit, usedSessions, usedAppointments, combinedUsage, usageLimitStartDate, usageLimitEndDate, membership, freeze, declinedRenewal.…. Required: member_id. - **momence_bought_membership_credits_bulk_update** — Update credits of a package-events or package-money bought membership for a specific member in Momence. Returns the updated bought membership credit information reflecting the new credit balance. Required: member_id, bought_membership_id. - **momence_bought_membership_membership_freezes_bulk_update** — Freeze a bought membership immediately or schedule a future freeze/unfreeze in Momence (host-scoped endpoint). Returns an empty 200 response on success. Required: member_id, bought_membership_id, freezeType, freezeAt, unfreezeType, unfreezeAt. - **bought_membership_membership_schedule_freezes_bulk_update** — Schedule a bought membership freeze in Momence. Returns an empty response on success. Required: member_id, bought_membership_id, freezeType, freezeAt. - **bought_membership_membership_schedule_freezes_bulk_delete** — Unfreeze a bought membership or remove a scheduled freeze in Momence. Returns an empty response on success. Required: member_id, bought_membership_id. - **bought_membership_membership_schedule_unfreezes_bulk_update** — Schedule a bought membership unfreeze for a specific member in Momence (host-scoped endpoint). Returns an empty 200 response on success. Required: member_id, bought_membership_id, unfreezeType, unfreezeAt. - **bought_membership_membership_schedule_unfreezes_bulk_delete** — Remove a scheduled membership unfreeze for a specific member's bought membership in Momence (host-scoped endpoint). Returns an empty 200 response on success. Required: member_id, bought_membership_id. - **list_all_momence_host_members** — List members (customers) associated with the current host in Momence. Returns: id, firstName, lastName, email, phoneNumber, pictureUrl, firstSeen, lastSeen, visits, customerFields, customerTags, memberId, firstSeenAt, lastSeenAt. Max 100 per page. - **create_a_momence_host_member** — Add a new member to a host in Momence. Returns the created member including memberId, email, firstName, lastName, firstSeenAt, and lastSeenAt. Required: email, firstName, lastName. - **get_single_momence_host_member_by_id** — Get a single member by id in Momence. Returns: id, email, visits, memberId. Required: id. - **momence_member_names_bulk_update** — Update a Momence member's first and last name. Returns: memberId, firstName, lastName, email. Required: member_id, firstName, lastName. - **momence_member_phone_numbers_bulk_update** — Update a member's phone number in Momence via the host API. Returns an empty 200 response on success. Required: member_id, phoneNumber. - **momence_member_phone_numbers_bulk_delete** — Delete all phone number records for a member in Momence via the host API. Returns an empty 200 response on success. Required: member_id. - **momence_member_emails_bulk_update** — Update a member's email address in Momence. Returns the updated member object including memberId, email, firstName, and lastName. Required: member_id, email. - **list_all_momence_host_memberships** — List available host memberships in Momence via the host API. Returns: id, name, description, type, locationId, disabled, autoRenewing, minimumAutoRenews, eventCredits, moneyCredits, duration, durationUnit, isActivatedOnFirstUse, activationDeadlineInDays, hasFreeTrial, freeTrialDurationInDays, contractAgreement, order, isIntroOffer, usageLimitForSessions, usageLimitForAppointments,… - **list_all_momence_member_notes** — List notes for a specific Momence member. Returns: id, createdAt, modifiedAt, type, note, imageLink, customerNoteTemplateId, sessionBookingId, appointmentReservationId, productOrderId, boughtMembershipId, paymentTransactionId, lockedAt, lockedByUserId. Max 100 items per page. Required: member_id. - **list_all_momence_member_sessions** — List session bookings for a specific member in Momence. Returns: id, createdAt, roomSpotId, checkedIn, cancelledAt, session. Required: member_id. - **create_a_momence_member_tag** — Assign a tag to a Momence member. Returns an empty 201 response on success. Required: member_id, tag_id. - **delete_a_momence_member_tag_by_id** — Unassign a tag from a Momence member. Returns an empty 200 response on success. Required: id, member_id. - **list_all_momence_host_sales** — List host sales in Momence, sorted newest-first by default. Returns each sale with memberId, customerName, customerEmail, paymentValue, paymentStatus, paymentMethod, paymentDate, saleItemId, transactionItems, saleReference, and details. Experimental feature — contact Momence support to enable. - **create_a_momence_session_booking_check_in** — Mark a Momence session booking as checked-in. Returns an empty response on success. Required: booking_id. - **momence_session_booking_check_ins_bulk_delete** — Remove the check-in from a Momence session booking, marking it as not checked-in. Returns an empty response on success. Required: booking_id. - **delete_a_momence_host_session_booking_by_id** — Cancel a single session booking in Momence by id. Returns an empty 200 response on success. Does not cancel or impact recurring bookings; a separate endpoint handles those. Required: id, refund, disableNotifications, isLateCancellation. - **delete_a_momence_host_session_recurring_booking_by_id** — Cancel a recurring session booking in Momence by id. This cancels both the recurring booking and all individual bookings originating from it; the id corresponds to the recurringBookingId field from the session booking list response. Returns an empty response on success. Required: id. - **list_all_momence_host_sessions** — List Momence host sessions with optional filtering by type, teacher, location, and date range. Returns: id, name, type, description, startsAt, endsAt, durationInMinutes, capacity, bookingCount, teacher, isRecurring, isCancelled, isInPerson, isDraft, inPersonLocation, onlineStreamUrl, onlineStreamPassword, bannerImageUrl, hostPhotoUrl, tags, sessionId, roomId, teacherId, payrateId, locationId,… - **get_single_momence_host_session_by_id** — Get a single Momence host session detail by id. Returns: sessionId, type, roomId, teacherId, payrateId, locationId, sessionTemplateId, sessionSemesterOccurrenceId, name, startsAt, endsAt, capacity, durationMinutes, description. Required: id. - **list_all_momence_session_bookings** — List session bookings for a specific Momence session. Returns each booking's id, recurringBookingId, firstName, lastName, and createdAt. Required: session_id. - **create_a_momence_bookings_free** — Add a member to a Momence session for free (staff action). Returns: sessionBookingId, sessionId, payingMemberId, targetMemberId. Required: session_id, memberId. - **create_a_momence_waitlist_booking** — Add a member to a session waitlist in Momence. Returns: sessionBookingId, sessionId, payingMemberId, targetMemberId. Required: session_id, memberId. - **list_all_momence_host_tags** — List available host tags in Momence. Returns: id, name, isCustomerBadge, badgeLabel, badgeColor, corporateTagId. Max 100 per page. - **list_all_momence_member_addresses** — List member addresses in Momence. Returns: id, address, zipcode, city, country, createdAt. Sort results by createdAt in ascending or descending order. - **create_a_momence_member_address** — Create a member address in Momence. Returns: id, address, zipcode, city, country, createdAt. Required: address, zipcode, city, country. - **get_single_momence_member_address_by_id** — Get a single member address by id in Momence. Returns: id, address, zipcode, city, country, createdAt. Required: id. - **update_a_momence_member_address_by_id** — Update a member address by id in Momence. Returns: id, address, zipcode, city, country, createdAt. Required: id, address, zipcode, city, country. - **delete_a_momence_member_address_by_id** — Delete a member address by id in Momence. Returns an empty response on success. Required: id. - **create_a_momence_member_checkout** — Perform checkout for a Momence member, processing payment for cart items. Returns the list of purchased items, each including id, type, sessionId, and attemptedPriceInCurrency. Only one item per request is currently supported; call /prices and /compatible-memberships before checkout to validate the cart. Required: items, paymentMethods. - **list_all_momence_members** — Get information about the currently logged-in Momence member. Returns: id, firstName, lastName, email, phoneNumber, pictureUrl, memberId. - **momence_members_bulk_update** — Update the currently logged-in Momence member's details. Email and phone number must be changed via the /email and /phone-number endpoints respectively. Returns an empty 200 response on success. Required: firstName, lastName. - **list_all_momence_member_visits** — List visit counts for the current authenticated member in Momence. Returns the member's visit count data as described by the MemberVisitsDto schema. No caller-supplied parameters are required. - **create_a_momence_member_password_reset_email** — Request a password reset email for a member in Momence. The endpoint triggers Momence to send a password reset email to the user. Returns an empty 201 response on success. - **list_all_momence_host_locations** — List available host locations in Momence. Returns: id, parentLocationId, name, timeZone, fullAddress, address, city, countryCode, zipCode, latitude, longitude, isPhysical. Max 200 per page. - **list_all_momence_host_signable_documents** — List signable documents (waivers, privacy policy, contracts) with signature status for the current member's host in Momence. Returns: id, type, status. - **momence_signable_documents_signs_bulk_update** — Sign one or multiple signable documents (waivers, privacy policy, contracts...) in Momence using a single signature. Returns an empty 200 response on success. Requires a JSON request body (MemberSignDocumentRequestDto). - **list_all_momence_member_saved_payment_methods** — List saved payment methods for the currently authenticated Momence member. Returns: paymentMethods. - **create_a_momence_member_saved_payment_method** — Generate a temporary pre-authenticated URL for adding a saved payment method via a Momence-hosted form. After the user completes, they are redirected back to the provided return URL. Returns: paymentMethods. The URL is valid for 3600 seconds. Required: redirectUrl. - **delete_a_momence_member_saved_payment_method_by_id** — Remove a saved payment method for the currently authenticated Momence member by id. Returns an empty 200 response on success. The last payment method cannot be deleted if the member has an active non-cancellable subscription. Required: id. - **create_a_momence_host_report** — Initiate report generation in Momence. Returns the report run with id, status, parameters, and data. Generation is async; poll the get endpoint for completed data. Required: parameters. - **get_single_momence_host_report_by_id** — Retrieve a Momence report run by id. Returns the report run with id, status, parameters, and data (including report items when completed). Required: id. - **create_a_momence_member_checkout_compatible_membership** — Get bought memberships potentially compatible with a Momence checkout cart, including incompatible ones with an incompatibility reason. Returns: items. Required: items. - **create_a_momence_member_checkout_price** — Fetch correct prices for every item in a member checkout cart in Momence before calling checkout. Returns: items with id, type, and price details for each cart item. The checkout endpoint will reject any request that doesn't contain correct prices, even when using memberships to pay. Required: items, paymentMethods. - **list_all_momence_member_bought_memberships_actives** — List active bought memberships for the authenticated member in Momence. Returns a paginated list of bought membership objects including boughtMembershipId and membership details such as subscription end dates and remaining event credits. - **momence_member_bought_membership_freezes_bulk_update** — Freeze a bought membership in Momence immediately or schedule a future freeze and unfreeze. Returns a 200 response on success. A JSON request body is required but its individual fields are not documented in the available source. Required: bought_membership_id, freezeType, freezeAt, unfreezeType, unfreezeAt. - **momence_member_bought_membership_schedule_freezes_bulk_update** — Schedule a future freeze for a bought membership in Momence. Returns a 200 response on success; no response body fields are documented in the API specification. Required: bought_membership_id, freezeType, freezeAt. - **momence_member_bought_membership_schedule_freezes_bulk_delete** — Remove a scheduled freeze or unfreeze a bought membership in Momence. Returns an empty 204 response on success. Required: bought_membership_id. - **momence_member_bought_membership_schedule_unfreezes_bulk_update** — Schedule a bought membership unfreeze in Momence for a future date. Returns an empty 200 response on success. Required: bought_membership_id, unfreezeType, unfreezeAt. - **momence_member_bought_membership_schedule_unfreezes_bulk_delete** — Remove a scheduled unfreeze from a bought membership in Momence. Returns an empty 200 response on success. Required: bought_membership_id. - **momence_member_self_phone_numbers_bulk_update** — Update the phone number of the currently authenticated Momence member. Changes the user's phone number via a JSON request body. Returns an empty 200 response on success. Required: phoneNumber. - **momence_member_self_phone_numbers_bulk_delete** — Delete all phone number records for the currently logged member in Momence. Returns an empty 200 response on success. No required parameters — the member is inferred from the authenticated session. - **momence_member_self_emails_bulk_update** — Update the email of the currently authenticated Momence member. Returns an empty response on success. A request body is required. Required: email. - **list_all_momence_member_host_memberships** — List available host memberships in Momence. Returns: id, name, description, type, locationId, disabled, autoRenewing, minimumAutoRenews, eventCredits, moneyCredits, duration, durationUnit, isActivatedOnFirstUse, activationDeadlineInDays, hasFreeTrial, freeTrialDurationInDays, contractAgreement, order, isIntroOffer, usageLimitForSessions, usageLimitForAppointments, combinedUsageLimitEnabled,… - **list_all_momence_member_host_sessions** — List available host sessions in Momence, filterable by session type, teacher, location, and date range. Returns: id, name, type, description, startsAt, endsAt, durationInMinutes, capacity, participants, waitlistEnabled, waitlistCapacity, salesCutoffInMinutes, isCancelled, priceType, fixedTicketPrice, dynamicTicketPriceMin, dynamicTicketPriceMax, dynamicTicketFreeOptionEnabled, teacher,… - **list_all_momence_member_self_sessions** — List session bookings for the currently authenticated Momence member. Returns: id, createdAt, roomSpotId, checkedIn, cancelledAt, isRecurring, session, sessionId, name, startsAt, endsAt. Supports sorting and date-based filtering via startAfter and endAfter. - **delete_a_momence_member_self_session_by_id** — Cancel a Momence session booking by id. Returns an empty 200 response on success. Required: id. - **list_all_momence_search_host_members** — Search and list Momence host members with filters. Returns: id, email, visits, memberId. Max 100 per page. Required: page, pageSize. ## How it works 1. **Link your customer's Momence account.** Use Truto's frontend SDK; we handle every OAuth and API key flow so you don't need to create the OAuth app. 2. **Authentication is automatic.** Truto refreshes tokens, stores credentials securely, and injects them into every API request. 3. **Call Truto's API to reach Momence.** The Proxy API is a 1-to-1 mapping of the Momence API. 4. **Get a unified response format.** Every response uses a single shape, with cursor-based pagination and data in the `result` field. ## Use cases - **Power white-labeled studio booking apps** — SaaS platforms that build branded mobile and web apps for boutique fitness studios can use Momence as the backend for schedules, memberships, and checkout — letting studios ship a custom-branded experience without Momence's generic consumer app. - **Sync members into retention and marketing CRMs** — Marketing automation tools can pull member profiles, visit history, active memberships, and freeze events to trigger churn-risk campaigns, and write tags back to Momence to segment audiences for downstream workflows. - **Consolidate multi-location franchise reporting** — BI and analytics platforms can connect to multiple Momence host accounts, trigger asynchronous host reports, and aggregate sales, memberships, and attendance data into a unified HQ dashboard. - **Automate membership lifecycle operations** — Ops and customer success tools can programmatically freeze, unfreeze, and adjust credits on bought memberships, giving studios a way to manage retention actions in bulk without manual work in the Momence admin. - **Enable aggregator and marketplace bookings** — Fitness marketplaces and class aggregators can read live session availability from studios and book members directly into free or paid spots through the Momence API. ## What you can build - **End-to-end booking and checkout flow** — Fetch host sessions, check compatible memberships, price the cart, run checkout, and place the member in the class or on the waitlist — all from your own UI. - **Membership freeze and credit management** — Ship a self-serve or staff-facing UI that bulk-updates credits, schedules future freezes and unfreezes, and cancels scheduled freeze events on active memberships. - **Member CRM sync with tagging** — Create and update host members, sync phone numbers and emails, search across members, and apply or remove segmentation tags to drive targeted campaigns. - **Attendance and check-in automation** — Automatically check members into sessions, cancel single or recurring bookings, and add members to classes for free based on rules from your own platform. - **Async sales and operations reporting** — Trigger host report generation, poll for completion, and pull sales, visits, and membership data into your analytics warehouse or BI dashboards. - **Digital waiver and document signing** — Fetch a studio's signable documents and bulk-sign waivers or privacy policies on behalf of members during onboarding into your app. ## FAQs ### How does authentication with Momence work through Truto? Truto handles the Momence auth flow — including token creation, profile lookup, and logout — so your end users (studio owners or members) connect their Momence account once and you get a stored connection to make API calls against. You don't need to manage token refresh or storage yourself. ### Can I run both host-side (studio) and member-side (customer) operations? Yes. The integration exposes host endpoints (members, sessions, sales, reports, tags, locations) as well as member-side endpoints (self bookings, self memberships, self payment methods, self session listings), so you can build either studio admin tools or consumer-facing apps on the same integration. ### Does the integration support the full checkout and payment flow? Yes. You can price a cart, verify a member's compatible memberships for a given session, and run host or member checkout. Saved payment methods can be listed, created, and deleted on the member side. ### How do I handle large data pulls for reporting? Momence exposes an asynchronous report pattern. You create a host report, then poll the get-report-by-id endpoint until it completes and returns the data — this avoids timeouts on large sales, visit, or membership datasets. ### Are bulk operations supported for member and membership updates? Yes. There are dedicated bulk endpoints for updating member names, phone numbers, and emails, as well as for bulk-updating membership credits, scheduling freezes and unfreezes, and signing documents — which is important for franchise-scale operations. ### How fresh is the data returned by the integration? All calls are made in real time against the Momence API, so reads reflect the current state at request time. For high-volume sync use cases, we recommend scheduling periodic pulls of members, sessions, and sales, and using the async report endpoints for heavier historical exports. ## Related reading - [Connect Momence to Claude: Manage Studio Sessions and Check-ins](https://truto.one/blog/connect-momence-to-claude-manage-studio-sessions-and-check-ins/) — Learn how to generate a managed MCP server for Momence using Truto. Connect Claude to automate studio sessions, member check-ins, and complex billing workflows. - [Connect Momence to ChatGPT: Automate Bookings and Memberships](https://truto.one/blog/connect-momence-to-chatgpt-automate-bookings-and-memberships/) — A complete engineering guide to connecting Momence to ChatGPT using a managed MCP server. Learn how to automate studio bookings, memberships, and waitlists. - [Connect Momence to AI Agents: Sync Member Data and Sales Reports](https://truto.one/blog/connect-momence-to-ai-agents-sync-member-data-and-sales-reports/) — Learn how to connect Momence to AI Agents using Truto's /tools endpoint. Build autonomous workflows to sync member profiles, process check-ins, and run reports.