Developer Portal
Register OAuth applications, manage credentials, and test your Coach Watts integration.
The Developer Portal is where you create and manage OAuth applications that connect to Coach Watts on behalf of athletes.
Getting started
- Sign in to Coach Watts
- Go to Settings → Developer or visit /developer
- Click Create Application
- Fill in your app details and save
You receive a client_id and client_secret. Store the secret securely — it is shown only once at creation.
Application settings
Each application has:
| Field | Purpose |
|---|---|
| Name & Logo | Shown on the OAuth consent screen |
| Redirect URIs | Allowed callback URLs for the authorization flow |
| Scopes | Permissions your app requests (see Scopes) |
| Webhook URL | Auto-generated incoming webhook endpoint (see Webhooks) |
| Webhook Secret | Authenticates incoming webhook payloads |
OAuth flow
- Redirect users to the authorization endpoint
- User approves scopes on the consent screen
- Receive an authorization code at your redirect URI
- Exchange the code for access and refresh tokens
- Use the access token in
Authorization: Bearerheaders
Testing your integration
- Interactive API explorer: /_docs/scalar (recommended) or /_docs/swagger
- OpenAPI spec: /_openapi.json
- Local development:
http://localhost:3099/api/with your dev credentials
Rate limits
| Type | Limit |
|---|---|
| Unauthenticated (per IP) | 100 requests / minute |
| Authenticated (per token) | 1,000 requests / minute |
MCP integration
To connect AI assistants instead of building a traditional app, see MCP Server. MCP uses OAuth with dynamic client registration — no manual app setup required for tools like Cursor.