---
title: "Create staff user"
method: POST
path: "/setting/create-staff"
tags: ["Setting"]
---

# Create staff user

`POST /setting/create-staff`

## Request

- Base URL: `https://demo.onlinebillingform.com/api/v2`
- URL: `https://demo.onlinebillingform.com/api/v2/setting/create-staff`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/billingserv/apis/billingserv-api-v2/docs/setting/create-staff/post.ts> (a function with typed inputs; its response is checked against the schema)

Use this BillingServ API endpoint to create staff user. Review the response for the operation result or validation errors.

## Request body

- object
  - `name` string, required
  - `email` string, email, required
  - `username` string, email, required
  - `password` string, password
  - `permission` StaffPermissionsRequest: Optional staff permissions. Set a permission to `Y` to enable it.
    - `dashboard` 'Y'
    - `packages` 'Y'
    - `customers` 'Y'
    - `invoices` 'Y'
    - `marketing` 'Y'
    - `reports` 'Y'
    - `support` 'Y'
    - `settings` 'Y'

## Response `200`

OK

- ApiResponse
  - `success` boolean

## Other responses

- `401`: Missing or invalid API key
- `403`: Authenticated key does not have permission for this endpoint
- `422`: Validation error

## Changes

- **2026-08-22** `6b9208b64456`: 1 breaking, 8 warning, 14 info
  - the `permission` request property type changed from `array` to `object`
  - removed the request property `permission.customers`
  - removed the request property `permission.dashboard`
  - removed the request property `permission.invoices`
  - …19 more

[Operation history](https://skmtc.dev/billingserv/apis/billingserv-api-v2/changes/setting/create-staff/post.md)

---

[API](https://skmtc.dev/billingserv/apis/billingserv-api-v2.md) - [All operations](https://skmtc.dev/billingserv/apis/billingserv-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/billingserv/apis/billingserv-api-v2/revisions/232ab5ca8413?raw)