Create subuser

POSThttps://www.eclipseproxy.com/api/reseller/v1/subusersBearer auth

Create a new subuser and allocate bandwidth from your pool. A secure password is generated and returned once in the response.

Example request

curl -X POST "https://www.eclipseproxy.com/api/reseller/v1/subusers" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username": "user1", "email": "[email protected]", "bandwidth": 100}'

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

usernamebodystringrequired

Desired username. Automatically prefixed with your store code (e.g. user1 becomes MYSTORE_user1).

emailbodystringrequired

Email for the subuser.

bandwidthbodynumberrequired

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 body

{
  "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

Status	Code	Reason
400	`INSUFFICIENT_BALANCE`	Not enough bandwidth available
409	`USERNAME_TAKEN`	A subuser with that username already exists
422	`MISSING_FIELDS`	A required field is missing
422	`INVALID_BANDWIDTH`	Bandwidth must be a positive number