Create POS User

POST /staff/v1/businessLocations/{businessLocationId}/userTypes/POS

OAuth2

Path parameters

businessLocationId integer(int64) Required

The unique identifier for the business location.

application/json

Body Required

username string Required

The staff username. Only used for POS staff.

Maximum length is 128.
pinCode string | null

The 4-digit pin code for the user.

Maximum length is 4.
firstName string

The first name of the user.

Maximum length is 128. Default value is empty.
lastName string

The last name of the user.

Maximum length is 128. Default value is empty.
active boolean

Indicates if the user is active.

Default value is true.
visible boolean

Indicates if the user is visible.

Default value is true.
group integer(int64)

The unique identifier for the user group.
reportAccess string

User report permissions.

Default value is STAFF_REPORT_OWN_ACCESS.
roles array[string]

List of roles assigned to the user. Normally, these are the default POS user roles. See Get All POS User Permissions for a list of roles.

Default value is [] (empty).

Responses

201 application/json

User created successfully
Hide response attributes Show response attributes object
- staffId integer(int64)
  
  The unique identifier for the user.
- username string
  
  The staff username. Only used for POS staff.
  
  Maximum length is 128.
- userTypes array[string]
  
  The user type.
  
  Values are POS, BACK_OFFICE, or API.
- firstName string
  
  The first name of the user.
  
  Maximum length is 128. Default value is empty.
- lastName string
  
  The last name of the user.
  
  Maximum length is 128. Default value is empty.
- email string(email)
  
  The email associated with the user. Only used for Back Office staff.
  
  Maximum length is 128.
- active boolean
  
  Indicates if the user is active.
  
  Default value is true.
- createdOn string(date-time)
  
  The timestamp of the creation of the user.
- modifiedOn string(date-time)
  
  The timestamp of the last update to the user.
- businessId integer(int64)
  
  The unique identifier for the business.
- businessLocationId integer(int64)
  
  The unique identifier for the business location.
- groups array[object]
  
  Hide groups attributes Show groups attributes object
  
  id integer(int64)
  
  The unique identifier for the user group.
  
  name string
  
  The name of the user group.
- reportAccess array[string]
  
  User report permissions.
  
  Default value is STAFF_REPORT_OWN_ACCESS.
- roles array[object]
  
  The roles assigned to the user.
  
  Hide roles attributes Show roles attributes object
  
  id integer(int64)
  
  The unique identifier for the role.
  
  name string
  
  The name of the role.
400

Bad request. Invalid input parameters.
401

Authentication failed.
403

Access Denied.
500

Internal Server Error.

POST /staff/v1/businessLocations/{businessLocationId}/userTypes/POS

curl \
 -X POST https://api.trial.lsk.lightspeed.app/staff/v1/businessLocations/{businessLocationId}/userTypes/POS \
 -H "Authorization: Bearer $ACCESS_TOKEN" \
 -H "Content-Type: application/json" \
 -d '{"username":"John Doe","pinCode":"1234","firstName":"John","lastName":"Doe","active":true,"visible":true,"group":42,"reportAccess":"STAFF_REPORT_OWN_ACCESS","roles":[]}'

Request examples

{
  "username": "John Doe",
  "pinCode": "1234",
  "firstName": "John",
  "lastName": "Doe",
  "active": true,
  "visible": true,
  "group": 42,
  "reportAccess": "STAFF_REPORT_OWN_ACCESS",
  "roles": []
}

Response examples (201)

{
  "staffId": 1234,
  "username": "John Doe",
  "userTypes": [
    "POS"
  ],
  "firstName": "John",
  "lastName": "Doe",
  "email": "hello@example.com",
  "active": true,
  "createdOn": "2024-05-04T09:42:00+00:00",
  "modifiedOn": "2024-05-04T09:42:00+00:00",
  "businessId": 12345,
  "businessLocationId": 1234567890,
  "groups": [
    {
      "id": 1234,
      "name": "Bar Staff"
    }
  ],
  "reportAccess": [
    "STAFF_REPORT_OWN_ACCESS"
  ],
  "roles": [
    {
      "id": 1234,
      "name": "ROLE_CAN_LOGIN"
    }
  ]
}