Skip to content
Docs menu

Back to all methods

createGear

write

POSTs `/gear-service/gear/v2`; defaults `usageType="DISTANCE", notes=""`; `firstUseDate` routed through `formatDate`; `gearType`/`usageType` upper-cased via `validateSportKey`; **converts** `maxUsageDistanceKm` -> `maxUsageDistanceMeters` (`round(km*1000)`, floor 1) and `maxUsageDurationMin` -> `maxUsageDurationSeconds` (`round(min*60)`, floor 1) — the opposite direction from `addWeighIn`'s "send raw" rule; returns the response unchecked

createGear(gearType, brand, model, name, firstUseDate, usageType?, maxUsageDistanceKm?, maxUsageDurationMin?, notes?, activityTypeKeys?)
ParameterTypeOptionalDescription
gearTypestringno
brandstringno
modelstringno
namestringno
firstUseDatestringnoCalendar date, YYYY-MM-DD (UTC)
usageType"distance" | "NONE" | "DISTANCE" | "DURATION" | "DATE" | "none" | "duration" | "date"yes
maxUsageDistanceKmnumberyes
maxUsageDurationMinnumberyes
notesstringyes
activityTypeKeysstring[]yes

In Claude this is the create_gear tool.

Guide: gear