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

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

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

Create or update campaign goal configs. List of thrown errors: [AuthenticationError]() [AuthorizationError]() [HeaderError]() [InternalError]() [QuotaError]() [RequestError]() [CampaignGoalConfigError]() [GoalServicesError]()

## Path parameters

- `customerId` string, required

## Request body

- GoogleAdsSearchads360V23ServicesMutateCampaignGoalConfigsRequest — Request message for CampaignGoalConfigService.MutateCampaignGoalConfigs.
  - `partialFailure` boolean — Optional. 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.
  - `validateOnly` boolean — Optional. If true, the request is validated but not executed. Only errors are returned, not results.
  - `operations` GoogleAdsSearchads360V23ServicesCampaignGoalConfigOperation[] — Required. The list of operations to perform on the campaign goal configs.
    - `updateMask` string, google-fieldmask — FieldMask that determines which fields are modified in an update.
    - `remove` string — Remove an existing campaign goal config.
    - `create` GoogleAdsSearchads360V23ResourcesCampaignGoalConfig — A link between a campaign and a goal enabling campaign-specific optimization.
      - `campaign` string — Immutable. The resource name of the campaign for this link.
      - `campaignRetentionSettings` GoogleAdsSearchads360V23CommonCampaignGoalSettingsCampaignRetentionGoalSettings — Retention campaign goal settings.
        - `valueSettingsOverride` GoogleAdsSearchads360V23CommonCustomerLifecycleOptimizationValueSettings — Lifecycle goal optimization value settings.
          - `additionalValue` number, double — Value of the lifecycle goal. For example, for retention goals, value is the incremental conversion value for lapsed customers who are not of high value.
          - `additionalHighLifetimeValue` number, double — High lifetime value of the lifecycle goal. For example, for customer acquisition goals, high lifetime value is the incremental conversion value for lapsed customers who are of high value. High lifetime value should be greater than value, if set.
        - `targetOption` 'UNSPECIFIED' | 'UNKNOWN' | 'TARGET_ALL' | 'TARGET_SPECIFIC' — Retention goal optimization mode for this campaign. Defaults to TARGET_ALL. Only customers on the allowlist can set target_option.
      - `goalType` 'UNSPECIFIED' | 'UNKNOWN' | 'CUSTOMER_RETENTION' — Output only. The goal type this link is attached to.
      - `resourceName` string — Immutable. The resource name of the campaign goal config. campaign goal config resource names have the form: `customers/{customer_id}/campaignGoalConfigs/{campaign_id}~{goal_id}`
      - `goal` string — Immutable. The resource name of the goal this link is attached to.
    - `update` GoogleAdsSearchads360V23ResourcesCampaignGoalConfig — A link between a campaign and a goal enabling campaign-specific optimization.
      - `campaign` string — Immutable. The resource name of the campaign for this link.
      - `campaignRetentionSettings` GoogleAdsSearchads360V23CommonCampaignGoalSettingsCampaignRetentionGoalSettings — Retention campaign goal settings.
        - `valueSettingsOverride` GoogleAdsSearchads360V23CommonCustomerLifecycleOptimizationValueSettings — Lifecycle goal optimization value settings.
          - `additionalValue` number, double — Value of the lifecycle goal. For example, for retention goals, value is the incremental conversion value for lapsed customers who are not of high value.
          - `additionalHighLifetimeValue` number, double — High lifetime value of the lifecycle goal. For example, for customer acquisition goals, high lifetime value is the incremental conversion value for lapsed customers who are of high value. High lifetime value should be greater than value, if set.
        - `targetOption` 'UNSPECIFIED' | 'UNKNOWN' | 'TARGET_ALL' | 'TARGET_SPECIFIC' — Retention goal optimization mode for this campaign. Defaults to TARGET_ALL. Only customers on the allowlist can set target_option.
      - `goalType` 'UNSPECIFIED' | 'UNKNOWN' | 'CUSTOMER_RETENTION' — Output only. The goal type this link is attached to.
      - `resourceName` string — Immutable. The resource name of the campaign goal config. campaign goal config resource names have the form: `customers/{customer_id}/campaignGoalConfigs/{campaign_id}~{goal_id}`
      - `goal` string — Immutable. The resource name of the goal this link is attached to.

## 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/revisions/40d087435afd/schema)