---
title: "Create a custom framework"
method: POST
path: "/api/v2/cloud_security_management/custom_frameworks"
tags: ["Security Monitoring"]
---

# Create a custom framework

`POST /api/v2/cloud_security_management/custom_frameworks`

Create a custom framework.

## Request body

- CreateCustomFrameworkRequest — Request object to create a custom framework.
  - `data` CustomFrameworkData, required — Contains type and attributes for custom frameworks.
    - `attributes` CustomFrameworkDataAttributes, required — Framework Data Attributes.
      - `description` string — Framework Description
      - `handle` string, required — Framework Handle
      - `icon_url` string — Framework Icon URL
      - `name` string, required — Framework Name
      - `requirements` CustomFrameworkRequirement[], required — Framework Requirements
        - `controls` CustomFrameworkControl[], required — Requirement Controls.
          - `name` string, required — Control Name.
          - `rules_id` string[], required — Rule IDs.
        - `name` string, required — Requirement Name.
      - `version` string, required — Framework Version
    - `type` 'custom_framework', required — The type of the resource. The value must be `custom_framework`.

## Response `200`

OK

- CreateCustomFrameworkResponse — Response object to create a custom framework.
  - `data` FrameworkHandleAndVersionResponseData, required — Contains type and attributes for custom frameworks.
    - `attributes` CustomFrameworkDataHandleAndVersion, required — Framework Handle and Version.
      - `handle` string — Framework Handle
      - `version` string — Framework Version
    - `id` string, required — The ID of the custom framework.
    - `type` 'custom_framework', required — The type of the resource. The value must be `custom_framework`.

## Other responses

- `400` — Bad Request
- `409` — Conflict
- `429` — Too many requests
- `500` — Bad Request

---

[API](https://skmtc.net/datadog/apis/api-v2.md) · [All operations](https://skmtc.net/datadog/apis/api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/datadog/api-v2/versions/da68bf029e4c/schema)