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

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

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

Creates or updates custom audiences. Operation statuses are returned. List of thrown errors: [AuthenticationError]() [AuthorizationError]() [CustomAudienceError]() [CustomInterestError]() [FieldError]() [FieldMaskError]() [HeaderError]() [InternalError]() [MutateError]() [OperationAccessDeniedError]() [PolicyViolationError]() [QuotaError]() [RequestError]()

## Path parameters

- `customerId` string, required

## Request body

- GoogleAdsSearchads360V23ServicesMutateCustomAudiencesRequest — Request message for CustomAudienceService.MutateCustomAudiences.
  - `operations` GoogleAdsSearchads360V23ServicesCustomAudienceOperation[] — Required. The list of operations to perform on individual custom audiences.
    - `remove` string — Remove operation: A resource name for the removed custom audience is expected, in this format: `customers/{customer_id}/customAudiences/{custom_audience_id}`
    - `updateMask` string, google-fieldmask — FieldMask that determines which resource fields are modified in an update.
    - `create` GoogleAdsSearchads360V23ResourcesCustomAudience — A custom audience. This is a list of users by interest. The unique key of a custom audience consists of the following fields: name. Violating the unique key constraint produces error: CustomAudienceError.NAME_ALREADY_USED
      - `id` string, int64 — Output only. ID of the custom audience.
      - `description` string — Description of this custom audience.
      - `resourceName` string — Immutable. The resource name of the custom audience. Custom audience resource names have the form: `customers/{customer_id}/customAudiences/{custom_audience_id}`
      - `name` string — Name of the custom audience. It should be unique for all custom audiences created by a customer. This field is required for creating operations.
      - `status` 'UNSPECIFIED' | 'UNKNOWN' | 'ENABLED' | 'REMOVED' — Output only. Status of this custom audience. Indicates whether the custom audience is enabled or removed.
      - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'AUTO' | 'INTEREST' | 'PURCHASE_INTENT' | 'SEARCH' — Type of the custom audience. ("INTEREST" OR "PURCHASE_INTENT" is not allowed for newly created custom audience but kept for existing audiences)
      - `members` GoogleAdsSearchads360V23ResourcesCustomAudienceMember[] — List of custom audience members that this custom audience is composed of. Members can be added during CustomAudience creation. If members are presented in UPDATE operation, existing members will be overridden.
        - `memberType` 'UNSPECIFIED' | 'UNKNOWN' | 'KEYWORD' | 'URL' | 'PLACE_CATEGORY' | 'APP' — The type of custom audience member, KEYWORD, URL, PLACE_CATEGORY or APP.
        - `placeCategory` string, int64 — A place type described by a place category users visit.
        - `url` string — An HTTP URL, protocol-included — at most 2048 characters, which includes contents users have interests in.
        - `keyword` string — A keyword or keyword phrase — at most 10 words and 80 characters. Languages with double-width characters such as Chinese, Japanese, or Korean, are allowed 40 characters, which describes the user's interests or actions.
        - `app` string — A package name of Android apps which users installed such as com.google.example.
    - `update` GoogleAdsSearchads360V23ResourcesCustomAudience — A custom audience. This is a list of users by interest. The unique key of a custom audience consists of the following fields: name. Violating the unique key constraint produces error: CustomAudienceError.NAME_ALREADY_USED
      - `id` string, int64 — Output only. ID of the custom audience.
      - `description` string — Description of this custom audience.
      - `resourceName` string — Immutable. The resource name of the custom audience. Custom audience resource names have the form: `customers/{customer_id}/customAudiences/{custom_audience_id}`
      - `name` string — Name of the custom audience. It should be unique for all custom audiences created by a customer. This field is required for creating operations.
      - `status` 'UNSPECIFIED' | 'UNKNOWN' | 'ENABLED' | 'REMOVED' — Output only. Status of this custom audience. Indicates whether the custom audience is enabled or removed.
      - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'AUTO' | 'INTEREST' | 'PURCHASE_INTENT' | 'SEARCH' — Type of the custom audience. ("INTEREST" OR "PURCHASE_INTENT" is not allowed for newly created custom audience but kept for existing audiences)
      - `members` GoogleAdsSearchads360V23ResourcesCustomAudienceMember[] — List of custom audience members that this custom audience is composed of. Members can be added during CustomAudience creation. If members are presented in UPDATE operation, existing members will be overridden.
        - `memberType` 'UNSPECIFIED' | 'UNKNOWN' | 'KEYWORD' | 'URL' | 'PLACE_CATEGORY' | 'APP' — The type of custom audience member, KEYWORD, URL, PLACE_CATEGORY or APP.
        - `placeCategory` string, int64 — A place type described by a place category users visit.
        - `url` string — An HTTP URL, protocol-included — at most 2048 characters, which includes contents users have interests in.
        - `keyword` string — A keyword or keyword phrase — at most 10 words and 80 characters. Languages with double-width characters such as Chinese, Japanese, or Korean, are allowed 40 characters, which describes the user's interests or actions.
        - `app` string — A package name of Android apps which users installed such as com.google.example.
  - `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)