Integrations & API

Strava connections are coming soon. When they arrive, your clients connect Strava themselves from Devices & Apps in their account, and activities they record there — runs, rides, swims and more — appear in their history and on their Client Detail page for you, with no duplicate logging.

Until then, most watches and trackers already write to Apple Health or Google Health Connect, and those reach Kounisou through the phone app (Profile → Health & recovery → Connect).

Garmin is coming soon — we are completing Garmin's developer-program approval. Once live, your clients connect it from Devices & Apps, and it imports activities recorded on Garmin devices and health metrics such as heart rate variability and sleep where available.

In the meantime, Garmin Connect can share steps, sleep and workouts with Apple Health (iPhone) or Health Connect (Android), which reach Kounisou through the phone app.

The Kounisou API is available on Pro plans (read-only, up to 1,000 requests/hour) and Studio and above (full read/write, up to 10,000 requests/hour). Enterprise plans have no rate limit.

To generate an API key:

1. Go to Settings → API.
2. Click Create API Key. Copy the key — it will not be shown again.
3. Include the key in the Authorization: Bearer <key> header with every request.

The full developer documentation lives at kounisou.com/developers and covers endpoints for clients, programs, check-ins, nutrition, calendar, messages, analytics, and webhooks, with a machine-readable OpenAPI spec at /api/v1/openapi.json. API keys can be revoked at any time from the API settings page.

Kounisou supports the Model Context Protocol (MCP) — the open standard that lets AI assistants like Claude work with your tools. Once connected, your assistant can list your clients, check adherence and nutrition, read check-in answers, and — on the Studio plan — send messages, assign programs, review check-ins, and add reminders. It only ever sees your own coaching data, and it acts with your API key's permissions, which you can revoke at any time.

To connect:

1. Go to Settings → API and generate an API key (Pro plan or above). Copy it — it is only shown once.
2. In your AI assistant, add Kounisou as an MCP server with the URL https://kounisou.com/api/mcp and the header Authorization: Bearer <your key>.
3. Ask it something like “Which of my clients need attention this week?” — it will use the Kounisou tools to answer.

Pro keys give your assistant read-only access; write actions (messaging clients, assigning programs) require a Studio key with write scope. Exact setup snippets for Claude and other clients are on the developers page. Treat API keys like passwords: use a separate key per assistant so you can revoke one without affecting the others.

Webhooks let your external systems receive real-time notifications when events happen in Kounisou — for example, when a client completes a workout, submits a check-in, or a payment succeeds. Webhooks are available on Pro plans (up to 5 endpoints) and Studio and above (unlimited).

To add a webhook endpoint:

1. Go to Settings → API → Webhooks → Add Endpoint.
2. Enter the URL that should receive POST requests.
3. Select the event types you want to subscribe to.
4. Save the endpoint. A signing secret is generated — use it to verify that incoming requests originate from Kounisou.

Each webhook delivery includes a payload with event type, timestamp, and relevant data. Failed deliveries are retried automatically up to three times with exponential back-off.

A Zapier integration is on our roadmap for Studio plans. Until it ships, you can build the same automations today with Webhooks and a tool like Make (formerly Integromat), or directly against the Kounisou API.