---
title: "Create Staff"
method: POST
path: "/staffs"
tags: ["Task"]
---

# Create Staff

`POST /staffs`

Create a schedule staff. The staff is created as active by default. Use `property_ids` to limit the staff to specific properties; the staff will be created with access to all properties when omitted.

For international operators, `mobile` must be in `+<country code> <number>` format (e.g. `+86 13800138000`).

## Request body

- object
  - `name` string, required — Display name of the staff (max 128 characters).
  - `mobile` string, required — Mobile number. International operators must use `+<country code> <number>` format.
  - `email` string — Email address.
  - `note` string — Free-form note (max 500 characters).
  - `property_ids` integer[] — Properties this staff can access. Omit to grant access to all properties available to the operator.

## Response `200`

The staff has been successfully created.

- object
  - `request_id` string, required — Unique identifier for the request.
  - `error_code` integer, required — Numeric error code representing the status of the response. A value of `200` indicates success. <br> See the [Error Codes](/reference/error-manual#error-codes) section for more information.
  - `error_msg` string, required — Message detailing the status of the response.
  - `data` object, required
    - `staff_id` integer, required — Unique identifier of the newly created staff.

---

[API](https://skmtc.net/hostex/apis/hostex-api.md) · [All operations](https://skmtc.net/hostex/apis/hostex-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hostex/hostex-api/versions/a3fa555dee66/schema)