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

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

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

Creates and removes ad group ad labels. Operation statuses are returned. List of thrown errors: [AuthenticationError]() [AuthorizationError]() [DatabaseError]() [HeaderError]() [InternalError]() [LabelError]() [MutateError]() [NewResourceCreationError]() [QuotaError]() [RequestError]()

## Path parameters

- `customerId` string, required

## Request body

- GoogleAdsSearchads360V23ServicesMutateAdGroupAdLabelsRequest — Request message for AdGroupAdLabelService.MutateAdGroupAdLabels.
  - `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` GoogleAdsSearchads360V23ServicesAdGroupAdLabelOperation[] — Required. The list of operations to perform on ad group ad labels.
    - `create` GoogleAdsSearchads360V23ResourcesAdGroupAdLabel — A relationship between an ad group ad and a label.
      - `resourceName` string — Immutable. The resource name of the ad group ad label. Ad group ad label resource names have the form: `customers/{owner_customer_id}/adGroupAdLabels/{ad_group_id}~{ad_id}~{label_id}`
      - `adGroupAd` string — Immutable. The ad group ad to which the label is attached.
      - `label` string — Immutable. The label assigned to the ad group ad.
      - `ownerCustomerId` string, int64 — Output only. The ID of the Customer which owns the label.
    - `remove` string — Remove operation: A resource name for the ad group ad label being removed, in this format: `customers/{customer_id}/adGroupAdLabels/{ad_group_id}~{ad_id}~{label_id}`
  - `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)