---
title: "Create new Billing Metric Access"
method: POST
path: "/v2/billing_metrics/access/create"
tags: ["Billing Metric"]
---

# Create new Billing Metric Access

`POST /v2/billing_metrics/access/create`

Create Billing Metric Access.

## Request body

- BillingMetricAccess
  - `metric_sys_id` string — The Sys ID of the metric
  - `native_detail_type` ServiceAccountNativeDetailsBaseForCloud
    - `type` string, required — Concrete type used for polymorphic deserialization (discriminator)
    - `access_type` 'read' | 'write' — Cloud access type to select
    - `servicenow_cmdb_configuration` ServiceNowCmdbConfigCreateRequest
      - `scope` 'master_account' | 'tenant' | 'cloud_account', required — Scope to Apply
      - `master_account_id` string — Master Account Id
      - `tenant_id` string — Id of the tenants that user has access to
      - `cloud_account_id` string — Id of the Cloud Account
      - `cmdb_account_id` string, required — Id of the ServiceNow Account
      - `cmdb_service` string, required — Name of the Cmdb Service
      - `configuration` object, required — ServiceNow Cmdb Sync Configuration, indexed by CloudServiceName
  - `sys_id` string — The Sys ID of the access assignment
  - `denied_identities` DeniedRolesAndUserGroups, required
    - `role_ids` string[] — Role IDs explicitly denied access
    - `user_group_ids` string[] — User groups explicitly denied access

## Response `200`

Success

- BillingMetricAccess
  - `metric_sys_id` string — The Sys ID of the metric
  - `native_detail_type` ServiceAccountNativeDetailsBaseForCloud
    - `type` string, required — Concrete type used for polymorphic deserialization (discriminator)
    - `access_type` 'read' | 'write' — Cloud access type to select
    - `servicenow_cmdb_configuration` ServiceNowCmdbConfigCreateRequest
      - `scope` 'master_account' | 'tenant' | 'cloud_account', required — Scope to Apply
      - `master_account_id` string — Master Account Id
      - `tenant_id` string — Id of the tenants that user has access to
      - `cloud_account_id` string — Id of the Cloud Account
      - `cmdb_account_id` string, required — Id of the ServiceNow Account
      - `cmdb_service` string, required — Name of the Cmdb Service
      - `configuration` object, required — ServiceNow Cmdb Sync Configuration, indexed by CloudServiceName
  - `sys_id` string — The Sys ID of the access assignment
  - `denied_identities` DeniedRolesAndUserGroups, required
    - `role_ids` string[] — Role IDs explicitly denied access
    - `user_group_ids` string[] — User groups explicitly denied access

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `500` — Internal Server Error

---

[API](https://skmtc.dev/corestack/apis/corestack-external-api.md) · [All operations](https://skmtc.dev/corestack/apis/corestack-external-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/corestack/corestack-external-api/revisions/bf2cdf20826d/schema)