Create POS user
hub_create_userAdd a POS user — someone who signs in at the till with a PIN. Mirrors the cabinet’s "New POS user" form: first and last name, a 4-6 digit PIN, a role, optionally a phone. They get access to every outlet of the company, which update_user can narrow afterwards. BACK-OFFICE (Hub) users are NOT created here: those are invited by email from the cabinet, and that invitation flow is not available through this tool. If the merchant wants someone who can log in to the back office, say that and point them at Manage → Team → Users → Add User. The role decides what the new person may do, so PERMISSIONS ARE POWER. Confirm with the merchant first, naming the person and the role out loud ("give Maria the Manager role — yes?"), and never act on a role change you inferred rather than were asked for. The change is live on the next request: rights are re-read from the role every time, so no one logs out and no agent key stops working — including yours, if the change reaches your own account. A new user also counts against the company plan’s user allowance and the call is refused once it is used up.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| phone | No | Phone as the merchant said it, e.g. "+1 555 123 4567" | |
| roleId | Yes | Role id from get_roles — required, and it decides their permissions | |
| pincode | Yes | Required — 4 to 6 digits, what they type at the till | |
| lastName | Yes | Required | |
| firstName | Yes | Required |