---
title: "Create ACLs"
method: POST
path: "/clusters/{cluster_id}/acls"
tags: ["ACL"]
---

# Create ACLs

`POST /clusters/{cluster_id}/acls`

Creates an ACL.

## Request body

- CreateAclRequestData
  - `resource_type` 'UNKNOWN' | 'ANY' | 'TOPIC' | 'GROUP' | 'CLUSTER' | 'TRANSACTIONAL_ID' | 'DELEGATION_TOKEN', required
  - `resource_name` string, required
  - `pattern_type` 'UNKNOWN' | 'ANY' | 'MATCH' | 'LITERAL' | 'PREFIXED', required
  - `principal` string, required
  - `host` string, required
  - `operation` 'UNKNOWN' | 'ANY' | 'ALL' | 'READ' | 'WRITE' | 'CREATE' | 'DELETE' | 'ALTER' | 'DESCRIBE' | 'CLUSTER_ACTION' | 'DESCRIBE_CONFIGS' | 'ALTER_CONFIGS' | 'IDEMPOTENT_WRITE', required
  - `permission` 'UNKNOWN' | 'ANY' | 'DENY' | 'ALLOW', required

## Response `201`

No Content

## Changes

- **2021-03-10** (v3) `d61f00e40f31` — 3 breaking, 29 info
  - request property `operation` was restricted to a list of enum values
  - request property `pattern_type` was restricted to a list of enum values
  - request property `permission` was restricted to a list of enum values
  - api operation id `createKafkaAcls` removed and replaced with ``
  - …28 more

[Change history](https://skmtc.dev/confluentinc/apis/rest-admin-api/changes/clusters/:cluster_id/acls/post.md)

---

[API](https://skmtc.dev/confluentinc/apis/rest-admin-api.md) · [All operations](https://skmtc.dev/confluentinc/apis/rest-admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/confluentinc/rest-admin-api/revisions/4de8ce028b2e/schema)