---
title: "Create a new role"
method: POST
path: "/role/"
tags: ["roles"]
---

# Create a new role

`POST /role/`

`visibility_user_lcf_ids` (optional)

A list of Lead Custom Field IDs that define which leads user with this role can see. If the role has `view_all_leads` permission, this field should be empty.

`visibility_user_lcf_behavior` (optional)

Defines how lead visibility works for leads that don't have assigned users. If the role has `view_all_leads` permission, this field should be empty.

 - `require_assignment` - leads without assigned users are not visible to this role
 - `allow_unassigned` - leads without assigned users are visible to this role

## Response `201`

Successful response

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `404` — Not found

---

[API](https://skmtc.net/close/apis/close-api.md) · [All operations](https://skmtc.net/close/apis/close-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/close/close-api/revisions/0dcf3303e9d7/schema)