---
title: "Add a new user"
method: POST
path: "/users"
tags: ["Users"]
---

# Add a new user

`POST /users`

Add a new user to the system. Users in the system must have unique emails. If successful, the path to the new user object is returned and a welcome email containing a temporary password will be sent to the email associated with the user. The login credentials expires in 24 hours. If the user does not login to the system within that time, a new invitation is required.

## Request body

- UserInput
  - `id` string
  - `displayName` string
  - `title` string
  - `email` string
  - `phoneNumber` string
  - `state` 'ACTIVE' | 'DISABLED' | 'EXPIRED'
  - `role` 'ADMIN' | 'FINANCE' | 'SALES' | 'SALES_MANAGER' | 'ACCOUNTANT' | 'BILLING_CLERK' | 'REVENUE_CLERK' | 'READ_ONLY' | 'EXECUTIVE' | 'CRM' | 'IMPORT' | 'BILLY_ADMIN' | 'BILLY_ENGINEER' | 'BILLY_SUPPORT' | 'BILLY_JOB'
  - `ssoOnly` boolean
  - `entityIds` string[]
  - `externalId` string

## Response `200`

successful operation

- string

---

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