---
title: "Create a new client role"
method: POST
path: "/clients/{id_client}/roles"
tags: ["client_roles"]
---

# Create a new client role

`POST /clients/{id_client}/roles`

## Request

- Base URL: `https://api.planvortex.com/v1.0.0`
- URL: `https://api.planvortex.com/v1.0.0/clients/{id_client}/roles`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (client credentials, token URL `https://api.planvortex.com/v1.0.0/oauth/token`)

Allow the creation of new client roles

## Path parameters

- `id_client` string, required

## Request body

- ClientsRolesRoleInput: Name and permission list of a role.
  - `name` string, required: Role name, shown when inviting a user.
  - `permissions` string[], required: Permissions granted by this role.

## Response `200`

Successful operation

- ClientsRolesRoleOne
  - `rol` ClientsRolesRole
    - `name` string
    - `permissions` ClientsRolesClientPermissions[]

## Other responses

- `400`: The request failed. The body carries the PlanVortex error code in `code`: | Code | Meaning | | --- | --- | | `521` | Invalid client. The identifier is invalid o doesn't exists |
- `500`: Unhandled error by the server

---

[API](https://skmtc.dev/planvortex/apis/planvortex-api.md) · [All operations](https://skmtc.dev/planvortex/apis/planvortex-api/llms.txt) · [OpenAPI document](https://skmtc.dev/planvortex/apis/planvortex-api/revisions/abedbbc1cd52?raw)