---
title: "CreateEmployeeRole"
method: POST
path: "/v1/me/roles"
tags: ["V1Employees"]
---

# CreateEmployeeRole

`POST /v1/me/roles`

Creates an employee role you can then assign to employees.

Square accounts can include any number of roles that can be assigned to
employees. These roles define the actions and permissions granted to an
employee with that role. For example, an employee with a "Shift Manager"
role might be able to issue refunds in Square Point of Sale, whereas an
employee with a "Clerk" role might not.

Roles are assigned with the [V1UpdateEmployee](https://developer.squareup.com/reference/square_2021-08-18/v1-employees-api/update-employee-role)
endpoint. An employee can have only one role at a time.

If an employee has no role, they have none of the permissions associated
with roles. All employees can accept payments with Square Point of Sale.

## Request body

- V1EmployeeRole — V1EmployeeRole
  - `created_at` string — The time when the employee entity was created, in ISO 8601 format. Is set by Square when the Role is created.
  - `id` string — The role's unique ID, Can only be set by Square.
  - `is_owner` boolean — If true, employees with this role have all permissions, regardless of the values indicated in permissions.
  - `name` string, required — The role's merchant-defined name.
  - `permissions` string[], required — The role's permissions.
  - `updated_at` string — The time when the employee entity was most recently updated, in ISO 8601 format. Is set by Square when the Role updated.

## Response `200`

Success

- V1EmployeeRole — V1EmployeeRole
  - `created_at` string — The time when the employee entity was created, in ISO 8601 format. Is set by Square when the Role is created.
  - `id` string — The role's unique ID, Can only be set by Square.
  - `is_owner` boolean — If true, employees with this role have all permissions, regardless of the values indicated in permissions.
  - `name` string, required — The role's merchant-defined name.
  - `permissions` string[], required — The role's permissions.
  - `updated_at` string — The time when the employee entity was most recently updated, in ISO 8601 format. Is set by Square when the Role updated.

---

[API](https://skmtc.net/square/apis/squareup.md) · [All operations](https://skmtc.net/square/apis/squareup/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/square/squareup/revisions/8d95e3639487/schema)