Skip to main content
POST
Create User

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Headers

X-Open-Wearables-API-Key
string | null

Body

application/json
first_name
string | null
Maximum string length: 100
last_name
string | null
Maximum string length: 100
email
string<email> | null
external_user_id
string | null
deprecated

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

id
string<uuid>
required
created_at
string<date-time>
required
first_name
string | null
last_name
string | null
email
string<email> | null
external_user_id
string | null
deprecated

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_at
string<date-time> | null
last_synced_provider
string | null
has_active_connection
boolean
default:false