Flowstate headless commerce API

Everything you need to sell classes and memberships, manage your studio, and sign your members in — from your own website and back-office systems. Two key kinds, two gateways:

Storefront API

Read-only public data (classes, schedule, memberships, instructors). Authenticated with a publishable key (flow_pk_…) — safe to ship in your website.

Storefront reference →

Management API

Server-to-server reads and scoped writes for your back-office (CRM, ERP, scheduling, cron). Authenticated with a secret key (flow_sk_…) — server-only.

Management reference →

Embeddable SDK

@flow/embed — one script tag adds a sign-in widget and typed storefront + members clients to your page. Your members never type a password on your DOM.

SDK guide →

MCP server

Let Claude or any AI assistant read and run your studio in plain language — connect with one-click sign-in or a secret key. Built on the same scopes as the Management API.

MCP guide →

Start here

  1. Quickstart — issue keys, make your first read and your first write in a few minutes.
  2. Authentication & scopes — pick the right key type and grant the smallest useful scope set.
  3. Storefront / Management reference — every operation, parameter, response, and runnable Try-it panel.
  4. Embeddable SDK — drop member sign-in and checkout straight into your site.
  5. MCP server — connect Claude or any AI assistant to your studio.

Generated from the published API specifications. Versioned at /v1; within v1 only additive changes are made.