API Reference

Create a role

post
https://api.cloudbeds.com/pos/settings/roles

Creates a custom role with no permissions. Grant them with PUT /pos/settings/roles/{role_id}/permissions.

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 role.

type is set server-side to "custom" — clients cannot self-assign
"system" (system roles are seeded and protected).

length ≤ 255
string
required
length between 1 and 255
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?