Skip to main content
POST
/
api
/
reseller
/
v1
/
subusers
Create subuser
curl --request POST \
  --url https://www.eclipseproxy.com/api/reseller/v1/subusers \
  --header 'Content-Type: application/json' \
  --data '
{
  "username": "<string>",
  "email": "<string>",
  "bandwidth": 123
}
'
Create a new subuser and allocate bandwidth from your pool. A secure password is generated and returned once in the response.

​
Authentication

Requires a reseller API key. Pass it as Authorization: Bearer YOUR_API_KEY or X-API-Key: YOUR_API_KEY. See Reseller overview.

​
Body parameters

​
username
string
required
Desired username. Automatically prefixed with your store code (e.g. user1 becomes MYSTORE_user1).
​
email
string
required
Email for the subuser.
​
bandwidth
number
required
Bandwidth to allocate, in MB. Must be a positive number and cannot exceed your available balance.

​
Response

Returns the created subuser, including the generated password. Store it now: it isn’t shown again.

​
Example request

{
  "username": "user1",
  "email": "[email protected]",
  "bandwidth": 100
}

​
Example response

{
  "status": "success",
  "message": "Subuser created",
  "messageCode": "SUBUSER_CREATED",
  "data": {
    "id": "subuser-125",
    "username": "MYSTORE_user1",
    "email": "[email protected]",
    "bandwidthBalance": 100,
    "createdAt": "2026-02-22T11:00:00Z",
    "whitelistIPs": [],
    "password": "GeneratedSecurePassword123!"
  }
}

​
Errors

StatusCodeReason
400INSUFFICIENT_BALANCENot enough bandwidth available
409USERNAME_TAKENA subuser with that username already exists
422MISSING_FIELDSA required field is missing
422INVALID_BANDWIDTHBandwidth must be a positive number