---
title: "Authenticate user"
method: POST
path: "/userauth"
tags: ["Users"]
---

# Authenticate user

`POST /userauth`

Authenticate user and return token for following authorizations

## Request body

- UserAuthRequestBody — UserAuthRequestBody
  - `email` string, required — User email address
  - `otp` string — One-time password
  - `password` string, required — User password

## Response `200`

Response

- UserAuthResponse — UserAuthResponse
  - `errors` object[] — List of errors occurred during request processing
    - `message` string, required — Printable error message
    - `more_info` string — URL to the documentation of the error
    - `status` integer, required — HTTP error status code
  - `message` string — Printable result of the request
  - `return_url` string — Return URL
  - `state` string, required — User account state
  - `tenant` string — Tenant identifier
  - `token` string, required — API session authentication token
  - `user_email` string, required — User email address

## Other responses

- `403` — Operation not allowed

---

[API](https://skmtc.net/aiven/apis/aiven-api-documentation.md) · [All operations](https://skmtc.net/aiven/apis/aiven-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aiven/aiven-api-documentation/revisions/042e78a96ad8/schema)