---
title: "POST /v1beta/{+parent}/customMetrics"
method: POST
path: "/v1beta/{+parent}/customMetrics"
tags: ["properties"]
---

# POST /v1beta/{+parent}/customMetrics

`POST /v1beta/{+parent}/customMetrics`

Creates a CustomMetric.

## Path parameters

- `parent` string, required

## Request body

- GoogleAnalyticsAdminV1betaCustomMetric — A definition for a custom metric.
  - `description` string — Optional. Description for this custom dimension. Max length of 150 characters.
  - `scope` 'METRIC_SCOPE_UNSPECIFIED' | 'EVENT' — Required. Immutable. The scope of this custom metric.
  - `parameterName` string — Required. Immutable. Tagging name for this custom metric. If this is an event-scoped metric, then this is the event parameter name. May only contain alphanumeric and underscore charactes, starting with a letter. Max length of 40 characters for event-scoped metrics.
  - `displayName` string — Required. Display name for this custom metric as shown in the Analytics UI. Max length of 82 characters, alphanumeric plus space and underscore starting with a letter. Legacy system-generated display names may contain square brackets, but updates to this field will never permit square brackets.
  - `restrictedMetricType` string[] — Optional. Types of restricted data that this metric may contain. Required for metrics with CURRENCY measurement unit. Must be empty for metrics with a non-CURRENCY measurement unit.
  - `name` string — Identifier. Resource name for this CustomMetric resource. Format: properties/{property}/customMetrics/{customMetric}
  - `measurementUnit` 'MEASUREMENT_UNIT_UNSPECIFIED' | 'STANDARD' | 'CURRENCY' | 'FEET' | 'METERS' | 'KILOMETERS' | 'MILES' | 'MILLISECONDS' | 'SECONDS' | 'MINUTES' | 'HOURS' — Required. The type for the custom metric's value.

## Response `200`

Successful response

---

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