v3
latestOpenAPI 3.1.02026-07-31121144224.9 KBExternal: Users
Create User
post/api/v1/users
Headers
X-Open-Wearables-API-Keystring nullable
Request body
first_namestring nullable
last_namestring nullable
emailstring email nullable
external_user_idstring nullable
Deprecated: no data-fetching endpoint (timeseries, workouts, sleep, summaries, health-scores, etc.) accepts external_user_id - they all require the Open Wearables UUID. This field was added early in the project but never wired into those endpoints, so it only works as a filter on GET /users. Store the UUID returned by POST /users in your own system instead.
Response
Successful Response
idstring uuid required
created_atstring date-time required
first_namestring nullable
last_namestring nullable
emailstring email nullable
external_user_idstring nullable
Deprecated: no data-fetching endpoint (timeseries, workouts, sleep, summaries, health-scores, etc.) accepts external_user_id - they all require the Open Wearables UUID. This field was added early in the project but never wired into those endpoints, so it only works as a filter on GET /users. Store the UUID returned by POST /users in your own system instead.
last_synced_atstring date-time nullable
last_synced_providerstring nullable
has_active_connectionboolean