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

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

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

Creates or updates a customer client link. Operation statuses are returned. List of thrown errors: [AuthenticationError]() [AuthorizationError]() [DatabaseError]() [FieldError]() [FieldMaskError]() [HeaderError]() [InternalError]() [ManagerLinkError]() [MutateError]() [NewResourceCreationError]() [QuotaError]() [RequestError]()

## Path parameters

- `customerId` string, required

## Request body

- GoogleAdsSearchads360V23ServicesMutateCustomerClientLinkRequest — Request message for CustomerClientLinkService.MutateCustomerClientLink.
  - `operation` GoogleAdsSearchads360V23ServicesCustomerClientLinkOperation — A single operation (create, update) on a CustomerClientLink.
    - `create` GoogleAdsSearchads360V23ResourcesCustomerClientLink — Represents customer client link relationship.
      - `status` 'UNSPECIFIED' | 'UNKNOWN' | 'ACTIVE' | 'INACTIVE' | 'PENDING' | 'REFUSED' | 'CANCELED' — This is the status of the link between client and manager.
      - `managerLinkId` string, int64 — Output only. This is uniquely identifies a customer client link. Read only.
      - `resourceName` string — Immutable. Name of the resource. CustomerClientLink resource names have the form: `customers/{customer_id}/customerClientLinks/{client_customer_id}~{manager_link_id}`
      - `hidden` boolean — The visibility of the link. Users can choose whether or not to see hidden links in the Google Ads UI. Default value is false
      - `clientCustomer` string — Immutable. The client customer linked to this customer.
    - `update` GoogleAdsSearchads360V23ResourcesCustomerClientLink — Represents customer client link relationship.
      - `status` 'UNSPECIFIED' | 'UNKNOWN' | 'ACTIVE' | 'INACTIVE' | 'PENDING' | 'REFUSED' | 'CANCELED' — This is the status of the link between client and manager.
      - `managerLinkId` string, int64 — Output only. This is uniquely identifies a customer client link. Read only.
      - `resourceName` string — Immutable. Name of the resource. CustomerClientLink resource names have the form: `customers/{customer_id}/customerClientLinks/{client_customer_id}~{manager_link_id}`
      - `hidden` boolean — The visibility of the link. Users can choose whether or not to see hidden links in the Google Ads UI. Default value is false
      - `clientCustomer` string — Immutable. The client customer linked to this customer.
    - `updateMask` string, google-fieldmask — FieldMask that determines which resource fields are modified in an update.
  - `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)