---
title: "Create new CMK"
method: POST
path: "/project/{project}/secrets/cmks"
tags: ["Secrets"]
---

# Create new CMK

`POST /project/{project}/secrets/cmks`

Request example: { "provider": "aws", "resource": "arn:aws:kms:us-east-1:123456789012:key/12345678-1234-1234-1234-123456789012" } Response example: { "cmk": { "id": "550e8400-e29b-41d4-a716-446655440000", "provider": "aws", "resource": "arn:aws:kms:us-east-1:123456789012:key/12345678-1234-1234-1234-123456789012", "status": "current", "default\_cmk": False, "created\_at": "2025-01-15T10:30:00Z", "updated\_at": "2025-01-15T10:30:00Z" } }

## Path parameters

- `project` string, required

## Request body

- CMKCreateRequestBody — CMKCreateRequestBody
  - `default_cmk` boolean — Mark the created CMK as default for all newly created services.
  - `provider` 'aws' | 'azure' | 'gcp' | 'oci', required — CMK provider
  - `resource` string, required — Resource name

## Response `200`

Response

- CMKCreateResponse — CMKCreateResponse
  - `cmk` object, required — CMK
    - `created_at` string, required — Created at
    - `default_cmk` boolean, required — CMK is used as a default for all newly created services.
    - `id` string, required — Customer Managed Key identifier (CMK ID)
    - `provider` 'aws' | 'azure' | 'gcp' | 'oci', required — CMK provider
    - `resource` string, required — Resource name
    - `status` 'current' | 'old' | 'deleted', required — Status
    - `updated_at` string, required — Updated at
  - `errors` object[] — List of errors occurred during request processing
    - `message` string, required — Printable error message
    - `more_info` string — URL to the documentation of the error
    - `status` integer, required — HTTP error status code
  - `message` string — Printable result of the request

## Other responses

- `403` — This feature is not enabled in your context, please contact support to enable it.
- `404` — Project not found

---

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