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

# POST /v1beta/{+parent}/customDimensions

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

Creates a CustomDimension.

## Path parameters

- `parent` string, required

## Request body

- GoogleAnalyticsAdminV1betaCustomDimension — A definition for a CustomDimension.
  - `name` string — Identifier. Resource name for this CustomDimension resource. Format: properties/{property}/customDimensions/{customDimension}
  - `displayName` string — Required. Display name for this custom dimension 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.
  - `parameterName` string — Required. Immutable. Tagging parameter name for this custom dimension. If this is a user-scoped dimension, then this is the user property name. If this is an event-scoped dimension, then this is the event parameter name. If this is an item-scoped dimension, then this is the parameter name found in the eCommerce items array. May only contain alphanumeric and underscore characters, starting with a letter. Max length of 24 characters for user-scoped dimensions, 40 characters for event-scoped dimensions.
  - `description` string — Optional. Description for this custom dimension. Max length of 150 characters.
  - `scope` 'DIMENSION_SCOPE_UNSPECIFIED' | 'EVENT' | 'USER' | 'ITEM' — Required. Immutable. The scope of this dimension.
  - `disallowAdsPersonalization` boolean — Optional. If set to true, sets this dimension as NPA and excludes it from ads personalization. This is currently only supported by user-scoped custom dimensions.

## 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)