---
title: "Create a new organization permission"
method: POST
path: "/organization_permissions"
tags: ["Organization Permissions"]
---

# Create a new organization permission

`POST /organization_permissions`

Creates a new organization permission for the given instance.

## Request body

- object
  - `name` string, required — The name of the permission.
  - `key` string, required — The key of the permission. Must have the format "org:feature:action" where feature and action are segments consisting of lowercase letters, digits, or underscores, for example "org:billing:manage" or "org:team:read". Cannot begin with "org:sys_" as that prefix is reserved for system permissions.
  - `description` string — A description of the permission.

## Response `200`

Success

- Permission
  - `object` 'permission', required
  - `id` string, required
  - `name` string, required
  - `key` string, required
  - `description` string, required
  - `type` string, required
  - `created_at` integer, required — Unix timestamp of creation.
  - `updated_at` integer, required — Unix timestamp of last update.

## Other responses

- `400` — Request was not successful
- `401` — Authentication invalid
- `402` — Payment required
- `404` — Resource not found
- `422` — Invalid request parameters

---

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