---
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.

---

[API](https://skmtc.net/mobilerun/apis/workflows.md) · [All operations](https://skmtc.net/mobilerun/apis/workflows/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mobilerun/workflows/revisions/1bc499aa8f99/schema)