---
title: "Create User"
method: POST
path: "/api/v1/users"
tags: ["External: Users"]
---

# Create User

`POST /api/v1/users`

## Headers

- `X-Open-Wearables-API-Key` string, nullable

## Request body

- UserCreate
  - `first_name` string, nullable
  - `last_name` string, nullable
  - `email` string, email, nullable
  - `external_user_id` string, 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 `201`

Successful Response

- UserRead
  - `id` string, uuid, required
  - `created_at` string, date-time, required
  - `first_name` string, nullable
  - `last_name` string, nullable
  - `email` string, email, nullable
  - `external_user_id` string, 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_at` string, date-time, nullable
  - `last_synced_provider` string, nullable
  - `has_active_connection` boolean

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/openwearables/apis/open-wearables-api.md) · [All operations](https://skmtc.net/openwearables/apis/open-wearables-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/openwearables/open-wearables-api/versions/37c1c527cd8f/schema)