Skip to main content
POST
Add a log entry

Authorizations

X-API-Key
string
header
required

API key generated from our app (Settings > API). Only one key can be active at a time.

Path Parameters

habitId
string
required

The unique identifier of the habit to log

Body

application/json
unitSymbol
enum<string>
required

Symbol representing the unit of measurement for habit goals and logs. Covers distance, volume, time, weight, energy, and count-based units.

Available options:
m,
kM,
ft,
yd,
mi,
floor,
L,
mL,
fl oz,
cup,
sec,
min,
hr,
ms,
kg,
g,
mg,
oz,
lb,
mcg,
J,
kJ,
kCal,
cal,
rep,
step
value
number
required

The value to log (e.g., 5 for "5 km", 30 for "30 minutes")

targetDate
string<date>

Date to record the log for (YYYY-MM-DD format). Defaults to today.

Response

Log entry created successfully

message
string
Example:

"Habit log created successfully"