Create Clerk organization permission

Create a new organization permission in a connected Clerk application.

← All Clerk endpoints · Capability overview

POST/v1/clerk/organization-permissions

https://api.vee3.io/v1/clerk/organization-permissions

10 tokens

Create a new organization permission in a connected Clerk application.

Authorization

Send your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

MCP

The same capability is available as an MCP tool on Vee3 hosted MCP.

Tool name

clerk.create_organization_permission

Parameters4 fields

clerk_instance_idstringOptional

Clerk instance id (ins_...) from clerk.get_connected_accounts. Omit to use the default connected account.

namestringRequired

Permission display name.

keystringRequired

Unique permission key.

descriptionstringOptional

Permission description.

Response8 fields

organization_permissionobject

7 fields

Newly created organization permission summary.

idstring

Clerk organization permission id.

namestring

Permission display name.

keystring

Permission key used in role assignments.

descriptionstring

Permission description.

typestring

Permission type (system or custom).

created_atinteger

Unix timestamp in milliseconds when the permission was created.

updated_atinteger

Unix timestamp in milliseconds when the permission was last updated.

HTTP errors: clerk_connection_required, clerk_connection_not_found, clerk_connection_invalid, validation_error, unauthorized, payment_required

Example request

Python

import requests

url = "https://api.vee3.io/v1/clerk/organization-permissions"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
}
payload = {
    "name": "billing-service",
    "key": "billing_service"
}

response = requests.post(url, headers=headers, json=payload)
response.raise_for_status()
data = response.json()
print(data)

Example responses1 example

200A newly created organization permission.

created_organization_permission.json

{
  "organization_permission": {
    "id": "orgperm_2abc123",
    "name": "Manage billing",
    "key": "org:sys_billing:manage",
    "description": "Manage organization billing",
    "type": "system",
    "created_at": 1710000000000,
    "updated_at": 1710000000000
  }
}