---
title: "Login user with Firebase token"
method: POST
path: "/api/users/login"
tags: ["Users"]
---

# Login user with Firebase token

`POST /api/users/login`

## Request

- Base URL: `https://api.hiyd.ai`
- URL: `https://api.hiyd.ai/api/users/login`
- Auth: HTTP bearer

## Request body

- object
  - `fcm_token` string

## Response `200`

Login successful

- object
  - `user` User
    - `id` string, uuid
    - `firebase_uid` string
    - `email` string, email
    - `first_name` string
    - `last_name` string
    - `display_name` string: Legacy full name, kept in sync server-side (trim(first_name || ' ' || last_name))
    - `phone_number` string
    - `profile_image_url` string
    - `date_of_birth` string, date
    - `gender` 'male' | 'female' | 'non_binary' | 'other' | 'prefer_not_to_say'
    - `height_cm` number
    - `weight_kg` number
    - `target_weight_kg` number
    - `activity_level` 'sedentary' | 'light' | 'moderate' | 'active' | 'very_active'
    - `fitness_goals` string[]
    - `daily_calorie_target` number
    - `onboarding_completed` boolean
    - `created_at` string, date-time
    - `last_active_at` string, date-time
  - `token` string

## Other responses

- `401`: Invalid Firebase token
- `404`: User not found

---

[API](https://skmtc.dev/hiyd/apis/hiyd-backend-api.md) - [All operations](https://skmtc.dev/hiyd/apis/hiyd-backend-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hiyd/apis/hiyd-backend-api/revisions/23598d347e1b?raw)