---
title: "Create sub-user"
method: POST
path: "/metered/networks/{network}/users"
tags: ["Sub-Users"]
---

# Create sub-user

`POST /metered/networks/{network}/users`

## Path parameters

- `network` 'residential' | 'mobile' | 'datacenter', required

## Request body

- CreateMeteredUserParams
  - `username` string, required
  - `bytes_quota` integer
  - `locked` boolean
  - `auto_lock` integer — Unix timestamp (UTC)
  - `binds` string[]
  - `ports` MeteredUserPortConfig[]
    - `location` string — ISO 3166-1 alpha-2 country code
    - `range_index` integer

## Response `201`

Created

- MeteredUser
  - `id` integer
  - `account_id` integer
  - `name` string
  - `password` string
  - `network` string
  - `status` string
  - `bytes_quota` integer
  - `bytes_used` integer
  - `auto_lock` integer — Unix timestamp after which the user is auto-locked (0 = disabled)
  - `binds` object[]
    - `addr` string
  - `ports` MeteredUserPortConfig[]
    - `location` string — ISO 3166-1 alpha-2 country code
    - `range_index` integer
  - `created_at` integer
  - `updated_at` integer

## Other responses

- `409` — Username already exists

---

[API](https://skmtc.dev/proxiware/apis/proxiware-api.md) · [All operations](https://skmtc.dev/proxiware/apis/proxiware-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/proxiware/proxiware-api/revisions/4e98e5b8cc44/schema)