API Reference

Add a staff member

post
https://api.cloudbeds.com/pos/staff/

Adds a staff member with a role, outlets and a login PIN. Get a PIN from GET /pos/staff/generate-pin; if someone takes it in the meantime, a new unique PIN is assigned. The response returns the PIN so it can be handed over.

Requires management access (a Cloudbeds user access token); a POS device token gets 403.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Payload for creating a new staff member.

pin is a client-supplied PIN obtained from GET /staff/generate-pin (the
UI never accepts hand-typed PINs). The server re-validates uniqueness on
save and auto-replaces a raced PIN, returning whatever was actually stored
in StaffResponse.pin so the manager can read it back.

array | null
length ≤ 255
^[^@\s]+@[^@\s]+\.[^@\s]+$
string
required
length between 1 and 255
string
required
length between 4 and 6
^\d+$
uuid
required
Headers
Responses

Updated about 3 hours ago

Did this page help you?
Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated about 3 hours ago

Did this page help you?