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 to 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: Sign in with SweatStack, the one-button login that replaces your auth stack, built on standard OAuth2.

Build your app

• Applications: register your app, manage credentials, and pick your publishing path (host it yourself, or on SweatStack Pages).
• Integrations: supported wearable platforms (Garmin Connect, Intervals.icu, Wahoo) and the roadmap.
• Workouts: schedule structured workouts and push them to the athlete's wearable.
• The Portal: the SweatStack-hosted page where a user fixes their account and comes back to you.

Advanced

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

Build

• AI coding: skills for AI agents, OpenAPI schema, prompting tips. The fastest way to ship working SweatStack code.
• Python SDK: the official client, with sign-in helpers for FastAPI and Streamlit.
• CLI: manage apps and deploy to Pages from the terminal.
• Tools: the in-browser Console REPL and a shareable Python playground.