Create account

Create account creates an application-user inside the current application. This operation is available only after successful Initialize.

Request

Create account uses packet type = 1.

{
  "type": 1,
  "id": 1,
  "login": "user@example.com",
  "password": "strong-password",
  "comment": "trial user",
  "license": "ABCDEF-123456",
  "credentials_type": 1
}

Prop

Type

Response

{
  "id": 1,
  "status": 1
}

When account creation is temporarily limited by IP, response may include retry_after:

{
  "id": 2,
  "status": 5,
  "retry_after": 86390
}

Prop

Type

Behavior notes

Per-IP create limit applies only when account is created without a linked license.
retry_after is best-effort and may be absent even when status is 5.

Create-account statuses

Status	Constant	Returned when
`1`	`Ok`	Account was created successfully.
`5`	`TooManyRequests`	Too many accounts were created from the same IP in the last 24h (limit: 3) for no-license account creation.
`6`	`InternalServerError`	Create-account request failed due to an internal server error.
`603`	`AppAccountsQuotaExceeded`	Application owner has reached the application plan limit for created accounts.
`100`	`LicenseNotFound`	Provided license was not found in this application.
`101`	`LicenseTooShort`	Provided license is shorter than 6 characters.
`102`	`LicenseTooLong`	Provided license is longer than 64 characters.
`106`	`LicenseAlreadyLinked`	Provided license is already linked to another application user and cannot be linked to this account.
`107`	`LicenseAlreadyActivated`	Provided license is already activated.
`202`	`AppUserAlreadyExists`	Account creation failed due to existing account/conflict at creation stage.
`204`	`AppUserRequiresLicense`	Application requires license for account creation, but request has no non-empty `license`.
`205`	`AppUserLoginTooShort`	`login` is shorter than 4 characters.
`206`	`AppUserLoginTooLong`	`login` is longer than 320 characters.
`207`	`AppUserPasswordTooShort`	`password` is shorter than 4 characters.
`208`	`AppUserPasswordTooLong`	`password` is longer than 64 characters.
`209`	`AppUserEmailInvalid`	`credentials_type = 1` but `login` is not a valid email format.
`210`	`AppUserCredentialsTypeInvalid`	`credentials_type` has unsupported value (must be 0 or 1).

Connection-close cases (before/around this usecase)

Create account itself returns JSON responses with status, but session can still be closed by protocol/session guards:

Close code	Error	When it happens
`4200`	`connection is not initialized`	Request was sent before successful `Initialize`.
`4201`	`rate limit hit`	Global per-session packet rate limit was exceeded.
`4302`	`invalid request body`	Packet body does not match the required schema for this operation.