Create Sub UID

Create a new sub user id. Use master user's api key only.

tip

The API key must have one of the below permissions in order to call this endpoint..

• master API key: "Account Transfer", "Subaccount Transfer", "Withdrawal"

HTTP Request

POST /user/v3/private/create-sub-member

Request Parameters

Parameter	Required	Type	Comments
username	true	string	Give a username of the new sub user id. 6-16 characters, must include both numbers and letters. cannot be the same as the exist or deleted one.
password	false	string	Set the password for the new sub user id. 8-30 characters, must include numbers, upper and lowercase letters.
memberType	true	integer	1: normal sub account, 6: custodial sub account
switch	false	integer	0: turn off quick login (default) 1: turn on quick login.
isUta	false	boolean	true: create UTA account false(default): create classic account
note	false	string	Set a remark

Response Parameters

Parameter	Type	Comments
uid	string	Sub user Id
username	string	Give a username of the new sub user id. 6-16 characters, must include both numbers and letters. cannot be the same as the exist or deleted one.
memberType	integer	1: normal sub account, 6: custodial sub account
status	integer	The status of the user account 1: normal 2: login banned 4: frozen
remark	string	The remark

Request Example

POST /user/v3/private/create-sub-member HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: xxxxxxxxxxxx
X-BAPI-API-KEY: xxxxxxxxxxxx
X-BAPI-TIMESTAMP: 1671174837503
X-BAPI-RECV-WINDOW: 50000
Content-Type: application/json
Content-Length: 109

{
    "username": "testsubaccount",
    "memberType": 1,
    "switch": 1,
    "note": "testnet subaccount"
}

Response Example

{
    "retCode": 0,
    "retMsg": "OK",
    "result": {
        "uid": "111111111",
        "username": "testsubaccount",
        "memberType": 1,
        "status": 1,
        "remark": "testnet subaccount"
    },
    "retExtInfo": {},
    "time": 1671174837668
}