---
title: "Create firm staff member"
method: POST
path: "/staff"
tags: ["Staff"]
---

# Create firm staff member

`POST /staff`

Creates a staff member in the firm associated with the authenticated client.

## Request body

- StaffDto
  - `userId` string, nullable — Unique identifier of the associated user. Used to map staff member to the specified user id and ignored if left blank. Use the FirmUsers API to remove a staff/user mapping.
  - `title` string, nullable — Staff member's title.
  - `firstName` string, nullable — Staff member's first name.
  - `middleName` string, nullable — Staff member's middle name (if applicable).
  - `lastName` string, nullable — Staff member's last name.
  - `initials` string, nullable — Staff member's initials.
  - `phone` PhoneNumberDto
    - `areaCode` string, nullable — Phone area code.
    - `number` string, nullable — Phone number (excluding area code).
  - `cell` PhoneNumberDto
    - `areaCode` string, nullable — Phone area code.
    - `number` string, nullable — Phone number (excluding area code).
  - `email` string, nullable — Staff member's email address.
  - `role` string, nullable — Staff member's role.
  - `avatar` string, nullable — Staff member's avatar.
  - `former` boolean, nullable — Whether he/she is a former member. Caution: Setting a staff member to former staff will also deregister them from the firm.
  - `colorFill` string, nullable — Staff member's fill color hex code.
  - `colorStroke` string, nullable — Staff member's stroke color hex code.

## Response `202`

When request is accepted. Returns a hypermedia 'Link' object of the staff member to be created.

- Link
  - `id` string, nullable
  - `href` string, nullable
  - `relation` string, nullable
  - `method` string, nullable

## Other responses

- `400` — When request is invalid.

---

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