Pterodactyl API v1
Subusers

Create User

Adds a user to the server

Fields

NameRequired?TypeDescriptionRules
emailrequiredstringEmail address of the user
permissionsrequiredobjectPermissions that user is permitted
POST/api/client/servers/{server}/users

Authorization

ClientToken
AuthorizationBearer <token>

Client API key (generated at /account/api)

In: header

Path Parameters

server*string

Server identifier (short 8-character ID)

Request Body

application/json

email*string
permissions*array<>

Response Body

application/json

curl -X POST "https://pterodactyl.file.properties/api/client/servers/1a7ce997/users" \  -H "Authorization: Bearer ptlc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \  -H "Accept: application/json" \  -H "Content-Type: application/json" \  -d '{  "email": "[email protected]",  "permissions": [    "control.console",    "control.start"  ]}'
{
  "object": "server_subuser",
  "attributes": {
    "uuid": "60a7aec3-e17d-4aa9-abb3-56d944d204b4",
    "identifier": "60a7aec3",
    "username": "subuser2jvc",
    "email": "[email protected]",
    "image": "https://gravatar.com/avatar/3bb1c751a8b3488f4a4c70eddfe898d8",
    "2fa_enabled": false,
    "created_at": "2020-06-12T23:31:41+01:00",
    "permissions": [
      "control.console",
      "control.start",
      "websocket.connect"
    ]
  }
}