Sign in
Ad Accounts

Accept, decline, cancel or end a manager link

Changes one manager-client link, identified by managerCustomerId, clientCustomerId and managerLinkId (all from GET /v1/ads/accounts/hierarchy). accept and decline answer a pending invitation as the client (CustomerManagerLinkService), so the connection's Google user needs direct access to the client account; access through a manager is not enough, because the link does not exist yet. cancel withdraws a pending invitation and unlink ends an active link, both as the manager (CustomerClientLinkService). Send validateOnly: true to have Google check the change without applying it.

patch/v1/ads/accounts/manager-links

Request body

accountIdstring required

Google ads SocialAccount id.

managerCustomerIdstring required

Manager customer id, digits only.

clientCustomerIdstring required

Client customer id, digits only.

managerLinkIdstring required

Numeric link id from GET /v1/ads/accounts/hierarchy.

action'accept' | 'decline' | 'cancel' | 'unlink' required
validateOnlyboolean

Response

Link updated, or validated only when validateOnly is true

managerCustomerIdstring
clientCustomerIdstring
managerLinkIdstring nullable

Null on a validateOnly invitation, where Google creates nothing.

status'PENDING' | 'ACTIVE' | 'REFUSED' | 'CANCELED' | 'INACTIVE'

Status the link has after this call.

validateOnlyboolean

Changes

Changed in 1 of the 57 revisions of this API.1