---
title: "POST /v23/customers/{+customerId}/labels:mutate"
method: POST
path: "/v23/customers/{+customerId}/labels:mutate"
tags: ["customers"]
---

# POST /v23/customers/{+customerId}/labels:mutate

`POST /v23/customers/{+customerId}/labels:mutate`

Creates, updates, or removes labels. Operation statuses are returned. List of thrown errors: [AuthenticationError]() [AuthorizationError]() [DatabaseError]() [DateError]() [DistinctError]() [FieldError]() [FieldMaskError]() [HeaderError]() [IdError]() [InternalError]() [LabelError]() [MutateError]() [NewResourceCreationError]() [NotEmptyError]() [NullError]() [OperatorError]() [QuotaError]() [RangeError]() [RequestError]() [ResourceCountLimitExceededError]() [SizeLimitError]() [StringFormatError]() [StringLengthError]()

## Path parameters

- `customerId` string, required

## Request body

- GoogleAdsSearchads360V23ServicesMutateLabelsRequest — Request message for LabelService.MutateLabels.
  - `partialFailure` boolean — If true, successful operations will be carried out and invalid operations will return errors. If false, all operations will be carried out in one transaction if and only if they are all valid. Default is false.
  - `operations` GoogleAdsSearchads360V23ServicesLabelOperation[] — Required. The list of operations to perform on labels.
    - `create` GoogleAdsSearchads360V23ResourcesLabel — A label.
      - `id` string, int64 — Output only. ID of the label. Read only.
      - `resourceName` string — Immutable. Name of the resource. Label resource names have the form: `customers/{owner_customer_id}/labels/{label_id}`
      - `name` string — The name of the label. This field is required and should not be empty when creating a new label. The length of this string should be between 1 and 80, inclusive.
      - `status` 'UNSPECIFIED' | 'UNKNOWN' | 'ENABLED' | 'REMOVED' — Output only. Status of the label. Read only.
      - `textLabel` GoogleAdsSearchads360V23CommonTextLabel — A type of label displaying text on a colored background.
        - `description` string — A short description of the label. The length must be no more than 200 characters.
        - `backgroundColor` string — Background color of the label in HEX format. This string must match the regular expression '^\#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$'. Note: The background color may not be visible for manager accounts.
    - `update` GoogleAdsSearchads360V23ResourcesLabel — A label.
      - `id` string, int64 — Output only. ID of the label. Read only.
      - `resourceName` string — Immutable. Name of the resource. Label resource names have the form: `customers/{owner_customer_id}/labels/{label_id}`
      - `name` string — The name of the label. This field is required and should not be empty when creating a new label. The length of this string should be between 1 and 80, inclusive.
      - `status` 'UNSPECIFIED' | 'UNKNOWN' | 'ENABLED' | 'REMOVED' — Output only. Status of the label. Read only.
      - `textLabel` GoogleAdsSearchads360V23CommonTextLabel — A type of label displaying text on a colored background.
        - `description` string — A short description of the label. The length must be no more than 200 characters.
        - `backgroundColor` string — Background color of the label in HEX format. This string must match the regular expression '^\#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$'. Note: The background color may not be visible for manager accounts.
    - `remove` string — Remove operation: A resource name for the label being removed, in this format: `customers/{customer_id}/labels/{label_id}`
    - `updateMask` string, google-fieldmask — FieldMask that determines which resource fields are modified in an update.
  - `responseContentType` 'UNSPECIFIED' | 'RESOURCE_NAME_ONLY' | 'MUTABLE_RESOURCE' — The response content type setting. Determines whether the mutable resource or just the resource name should be returned post mutation.
  - `validateOnly` boolean — If true, the request is validated but not executed. Only errors are returned, not results.

## Response `200`

Successful response

---

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