---
title: "Create sub user"
method: POST
path: "/v2/sub-users"
tags: ["Sub-users"]
---

# Create sub user

`POST /v2/sub-users`

Create a new sub user for Residential subscription

## Request body

- object
  - `username` string, json, required — From 6 to 64 characters long. Only letters, numbers and underscores allowed.
  - `password` string, json, required — Must include: 12 or more characters; at least one upper case letter; one lower case letter; one number; one of these symbols `_` `~` `+` `=` (`@` and `:` are not allowed).
  - `service_type` 'residential_proxies', required
  - `traffic_limit` number, float
  - `auto_disable` boolean — Disables subuser when the traffic limit is hit
  - `traffic_count_from` string, date — Handles subuser subscription traffic starting from the specified date. Use date format yyyy-mm-dd hh:mm:ss.

## Response `201`

201

- object

## Other responses

- `400` — 400

---

[API](https://skmtc.dev/decodo/apis/smartproxy.md) · [All operations](https://skmtc.dev/decodo/apis/smartproxy/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/decodo/smartproxy/revisions/561ae165491a/schema)