---
title: "Initiate authentication for a user"
method: POST
path: "/auth/user-auth/initiate"
tags: ["auth-userauth"]
---

# Initiate authentication for a user

`POST /auth/user-auth/initiate`

Initiate authentication for a user. If the email address is for a new user, a new onboard profile will be created

## Request body

- UserAuthInitRequest
  - `email` string, required — user's email

## Response `200`

Success

- UserAuthInitResponse
  - `authSessionId` string, uuid — The log in session ID of the user, valid for the duration of the OTP validity
  - `isReturning` boolean — Indicates if user is a returning user, i.e. previously verified

## Other responses

- `400` — Bad request
- `401` — Unauthorized request
- `404` — Not found
- `500` — Server error

---

[API](https://skmtc.net/nestechops/apis/onboard-external-api-gateway.md) · [All operations](https://skmtc.net/nestechops/apis/onboard-external-api-gateway/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nestechops/onboard-external-api-gateway/revisions/29661adc1ffc/schema)