---
title: "Add a new role definition)"
method: POST
path: "/1.0/kb/security/roles"
tags: ["Security"]
---

# Add a new role definition)

`POST /1.0/kb/security/roles`

## Headers

- `X-Killbill-CreatedBy` string, required
- `X-Killbill-Reason` string
- `X-Killbill-Comment` string

## Request body

- RoleDefinition
  - `role` string, required
  - `permissions` string[], required

## Response `201`

Role definition created successfully

- RoleDefinition
  - `role` string, required
  - `permissions` string[], required

---

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