Create a manager

POST /api/v1/managers prm_managers_create

Creates a staff or reseller account. A manager needs at least one login identity, so email or username must be present.

At a glance

Authentication: Staff token or session
Requires permission: prm_managers_create Create managers
Rate limit: t_mutate

Parameters

Parameter	Description
`email` body · string	Login email. Unique within the tenant. Required unless username is given.
`username` body · string	Login username. Required unless email is given.
`password`required body · string	Hashed with Argon2id before storage, unlike a subscriber's.
`parent_manager_id` body · integer	Defaults to the caller. Never null — a tenant keeps exactly one root manager, its owner. A named parent must be one the caller may act on.

Errors

Code	When it is returned
`ERR_CONFLICT`409	the email is already registered in this tenant
`ERR_CONFLICT`409	the licensed manager ceiling is reached

Request

curl -X POST "$BASE/api/v1/managers" \
  -H "Authorization: Bearer $XR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "email": "giza@acme.example",
  "username": "giza-reseller",
  "password": "a-strong-password",
  "firstname": "Mona",
  "parent_manager_id": 41
}'

BASE is your tenant host: the same address you sign in on.

Try it on your own network.

50 subscribers for 7 days. You pay nothing.

Try it free Talk to us