---
title: "PUT /userprofiles/{userprofilesId}/creativeFields"
method: PUT
path: "/userprofiles/{userprofilesId}/creativeFields"
tags: ["creativeFields"]
---

# PUT /userprofiles/{userprofilesId}/creativeFields

`PUT /userprofiles/{userprofilesId}/creativeFields`

## Request

- Base URL: `https://dfareporting.googleapis.com/dfareporting/v5`
- URL: `https://dfareporting.googleapis.com/dfareporting/v5/userprofiles/{userprofilesId}/creativeFields`
- Auth: OAuth 2 and OAuth 2
  - Implicit: `https://accounts.google.com/o/oauth2/auth`
  - Scopes: `https://www.googleapis.com/auth/dfatrafficking`
  - Authorization code: `https://accounts.google.com/o/oauth2/auth`
  - Token URL: `https://accounts.google.com/o/oauth2/token` scopes: `https://www.googleapis.com/auth/dfatrafficking`
- TypeScript: <https://skmtc.dev/google/apis/dfareporting/docs/userprofiles/:userprofilesId/creativeFields/put.ts> (a function with typed inputs; its response is checked against the schema)

Updates an existing creative field.

## Path parameters

- `userprofilesId` string, required

## Request body

- CreativeField: Contains properties of a creative field.
  - `accountId` string, int64: Account ID of this creative field. This is a read-only field that can be left blank.
  - `advertiserId` string, int64: Advertiser ID of this creative field. This is a required field on insertion.
  - `advertiserIdDimensionValue` DimensionValue: Represents a DimensionValue resource.
    - `dimensionName` string: The name of the dimension.
    - `etag` string: The eTag of this response for caching purposes.
    - `id` string: The ID associated with the value if available.
    - `kind` string: The kind of resource this is, in this case dfareporting#dimensionValue.
    - `matchType` 'EXACT' | 'BEGINS_WITH' | 'CONTAINS' | 'WILDCARD_EXPRESSION': Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
    - `value` string: The value of the dimension.
  - `id` string, int64: ID of this creative field. This is a read-only, auto-generated field.
  - `kind` string: Identifies what kind of resource this is. Value: the fixed string "dfareporting#creativeField".
  - `name` string: Name of this creative field. This is a required field and must be less than 256 characters long and unique among creative fields of the same advertiser.
  - `subaccountId` string, int64: Subaccount ID of this creative field. This is a read-only field that can be left blank.

## Response `200`

Successful response

- CreativeField: Contains properties of a creative field.
  - `accountId` string, int64: Account ID of this creative field. This is a read-only field that can be left blank.
  - `advertiserId` string, int64: Advertiser ID of this creative field. This is a required field on insertion.
  - `advertiserIdDimensionValue` DimensionValue: Represents a DimensionValue resource.
    - `dimensionName` string: The name of the dimension.
    - `etag` string: The eTag of this response for caching purposes.
    - `id` string: The ID associated with the value if available.
    - `kind` string: The kind of resource this is, in this case dfareporting#dimensionValue.
    - `matchType` 'EXACT' | 'BEGINS_WITH' | 'CONTAINS' | 'WILDCARD_EXPRESSION': Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
    - `value` string: The value of the dimension.
  - `id` string, int64: ID of this creative field. This is a read-only, auto-generated field.
  - `kind` string: Identifies what kind of resource this is. Value: the fixed string "dfareporting#creativeField".
  - `name` string: Name of this creative field. This is a required field and must be less than 256 characters long and unique among creative fields of the same advertiser.
  - `subaccountId` string, int64: Subaccount ID of this creative field. This is a read-only field that can be left blank.

---

[API](https://skmtc.dev/google/apis/dfareporting.md) - [All operations](https://skmtc.dev/google/apis/dfareporting/llms.txt) - [OpenAPI document](https://skmtc.dev/google/apis/dfareporting/revisions/be73a9a450de?raw)
