---
title: "Create a SOCKS5 user"
method: POST
path: "/connect/users"
tags: ["Users"]
---

# Create a SOCKS5 user

`POST /connect/users`

Creates a SOCKS5 credential, optionally bound to a proxy for dedicated routing. Username and password are generated when omitted.

## Request body

- CreateUserRequest
  - `password` string — Desired SOCKS5 password, 1-255 bytes (RFC 1929). Generated when omitted.
  - `proxyId` string, uuid — Proxy to bind the user to for dedicated routing.
  - `username` string — Desired SOCKS5 username, 1-255 bytes (RFC 1929). Generated when omitted.

## Response `201`

The created user, including its password.

- UserWithSecret — A SOCKS5 user including its password. Returned only on create and single-user reads.
  - `createdAt` string, date-time, required
  - `id` string, uuid, required
  - `proxyId` string, uuid, nullable — The proxy this user routes to (dedicated routing), or null if unbound.
  - `username` string, required
  - `password` string, required

## Other responses

- `400` — The request was invalid.
- `401` — The X-User-ID header was missing or invalid, or a present X-Owner-Id header was not a uuid.

## Changes

- **2026-07-08** `6d835ec1e768` — 1 info
  - the endpoint scheme security `OwnerIDHeader AND UserIDHeader` was added to the API
- **2026-07-01** `1229ad911e2e` — 2 info
  - api tag `Users` added
  - api tag `users` removed
- **2026-06-05** `49b7fa16d8f6` — 1 info
  - endpoint added
- **2026-05-30** `51d2493ba0f4` — 1 breaking
  - api path removed without deprecation
- **2026-05-30** `d06ce0f3c00d` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/droidrun/apis/droidrun-cloud/changes/connect/users/post.md)

---

[API](https://skmtc.dev/droidrun/apis/droidrun-cloud.md) · [All operations](https://skmtc.dev/droidrun/apis/droidrun-cloud/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/droidrun/droidrun-cloud/revisions/3183ec3153d1/schema)