---
title: "POST /users/{userID}/authEvents"
method: POST
path: "/users/{userID}/authEvents"
tags: ["AuthEvents"]
---

# POST /users/{userID}/authEvents

`POST /users/{userID}/authEvents`

Create a new authentication event for a user

## Path parameters

- `userID` string, required

## Request body

- AuthEventCreateReq
  - `username` string, required
  - `eventType` 'sign_up' | 'login' | 'new_passkey_added', required
  - `method` 'password' | 'email_otp' | 'email_link' | 'phone_otp' | 'passkey' | 'social_github' | 'social_google' | 'social_microsoft', required
  - `status` 'success' | 'failure', required
  - `clientInformation` ClientInformation, required
    - `remoteAddress` string, required — Client's IP address
    - `userAgent` string, required — Client's user agent
    - `clientEnvHandle` string — Client's environment handle
    - `javascriptFingerprint` string — Client's fingerprint
    - `javaScriptHighEntropy` JavaScriptHighEntropy
      - `platform` string, required
      - `platformVersion` string, required
      - `mobile` boolean, required
    - `bluetoothAvailable` boolean — Client's Bluetooth availability
    - `passwordManagerAvailable` boolean — Client's password manager availability
    - `userVerifyingPlatformAuthenticatorAvailable` boolean, required
    - `conditionalMediationAvailable` boolean, required
    - `clientCapabilities` ClientCapabilities, required
      - `conditionalCreate` boolean
      - `conditionalMediation` boolean
      - `hybridTransport` boolean
      - `passkeyPlatformAuthenticator` boolean
      - `userVerifyingPlatformAuthenticator` boolean
    - `privateMode` boolean
    - `parsedDeviceInfo` ParsedDeviceInfo, required
      - `browserName` string, required
      - `browserVersion` string, required
      - `osName` string, required
      - `osVersion` string, required
    - `nativeMeta` NativeMeta
      - `build` string, required
      - `deviceOwnerAuth` string
      - `isPlatformAuthenticatorAPISupported` boolean
      - `isBluetoothAvailable` boolean
      - `isBluetoothOn` boolean
      - `googlePlayServices` boolean
      - `deviceSecure` boolean
      - `brand` string
      - `model` string

## Response `200`

Auth event has been created.

- AuthEvent
  - `authEventID` string, required
  - `userID` string, required — ID of the user
  - `username` string, required
  - `eventType` 'sign_up' | 'login' | 'new_passkey_added', required
  - `method` 'password' | 'email_otp' | 'email_link' | 'phone_otp' | 'passkey' | 'social_github' | 'social_google' | 'social_microsoft', required
  - `created` string, required — Timestamp of when the entity was created in yyyy-MM-dd'T'HH:mm:ss format
  - `createdMs` integer, required
  - `status` 'success' | 'failure', required

## Other responses

- `default` — Error

---

[API](https://skmtc.net/corbado/apis/corbado-backend-api.md) · [All operations](https://skmtc.net/corbado/apis/corbado-backend-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/corbado/corbado-backend-api/versions/1f6143efe426/schema)