---
title: 'Create user device'
description: 'This endpoint is used to create user devices for fraud tracking'
openapi: POST /api/users/devices
---

> **For AI agents:** the complete documentation index is at [llms.txt](https://docs.snagsolutions.io/llms.txt). Append `.md` to any page URL for its markdown version.

`POST /api/users/devices`

`POST https://admin.snagsolutions.io/api/users/devices`

This endpoint is used to create user devices for fraud tracking

## Authentication

- `apiKeyAuth` — apiKey in header: `X-API-KEY`

## Request body

- Content type: `application/json`
  - request body (object) — Schema for a create user device schema
    - `userId` (string, uuid)
    - `walletAddress` (string)
    - `ipAddress` (string, required) — IP address of the user device
    - `deviceIdentifier` (string) — Persistent identifier of the browser or device (e.g. a fingerprint ID), used to detect several accounts on one device

## Response 201

201
  - response (object) — The device is queued for processing; the response does not wait for it to be stored
    - `message` (string, required)

## Response 400

400
  - response (object) — Schema for bad request response
    - `message` (string, required) — Error message

## Response 403

403
  - response (object) — Schema for forbidden response
    - `message` (string, required) — Error message

## Response 500

500
  - response (object) — Schema for internal server error response
    - `success` (boolean, required) — Indicates operation success
    - `message` (string, required) — Error message
    - `debugInfo` (string) — Optional debug information


---

📦 **OpenAPI specs:** Every OpenAPI specification referenced by this documentation is available as a single download — https://docs.snagsolutions.io/api-specs.zip