---
title: "Create a tracker definition"
method: POST
path: "/groups/{groupId}/trackers"
tags: ["Legacy (v1-compat)"]
---

# Create a tracker definition

`POST /groups/{groupId}/trackers`

## Request

- Base URL: `https://whatareyoudo.ing/api/v1`
- URL: `https://whatareyoudo.ing/api/v1/groups/{groupId}/trackers`
- Auth: HTTP bearer

## Path parameters

- `groupId` string, uuid, required

## Request body

- CompatCreateTrackerRequest
  - `name` string, required
  - `kind` 'number' | 'scale' | 'mood' | 'text' | 'check' | 'characters', required
  - `unit` string, nullable
  - `minValue` number, nullable
  - `maxValue` number, nullable

## Response `201`

Created

- CompatTrackerDefinition
  - `id` string, uuid, required
  - `name` string, required
  - `kind` 'number' | 'scale' | 'mood' | 'text' | 'check' | 'characters', required
  - `unit` string, nullable, required
  - `min_value` number, nullable, required
  - `max_value` number, nullable, required
  - `can_edit` boolean: Whether the caller may change or remove it: its creator, or the group's owner/admin (never an admin of a system group). Present on list responses.

---

[API](https://skmtc.dev/whatareyoudo/apis/whatcha-api.md) · [All operations](https://skmtc.dev/whatareyoudo/apis/whatcha-api/llms.txt) · [OpenAPI document](https://skmtc.dev/whatareyoudo/apis/whatcha-api/revisions/48dd8a54abea?raw)