Learn

Concepts and reference material for building on SweatStack. If you haven't yet, get started first. Two minutes to your first API call, fifteen for a working OAuth app.

Start here

• Data: the shape of every entity in SweatStack (activities, dailies, tests, metabolic profile) and how to query them. Read this first; everything else assumes it.
• Authentication: OAuth2 for the standard flow, plus SweatStack Connect for frictionless onboarding via wearable accounts.

Build your app

• Applications: register your app, manage credentials, and pick your publishing path (host it yourself, or via SweatStack Pages).
• Integrations: supported wearable platforms (Garmin, Intervals.icu) and the roadmap.

Advanced

• Webhooks and app metadata: real-time event subscriptions and per-app JSON storage on activities, traces, tests, and users.

Build with

• AI coding: skills for AI agents, OpenAPI schema, prompting tips. The fastest way to ship working SweatStack code.
• Python SDK: the official client. Class-based and module-level interfaces.
• CLI: manage apps and deploy to Pages from the terminal.
• Frameworks: drop-in helpers for FastAPI, Streamlit, and Jupyter.
• Tools: in-browser Console REPL, sharable Python playground.