Sign in
Ad Accounts

Invite a client account to a manager

Sends a manager-to-client link invitation from managerCustomerId to clientCustomerId (Google's CustomerClientLinkService). The manager must be one the connection's Google user reaches, directly or under another manager (see GET /v1/ads/accounts/hierarchy); the client can be any Google Ads account. The link stays PENDING until someone with access to the client accepts it in Google Ads or through PATCH on this path. Not idempotent: Google refuses a second invitation while one is pending. Send validateOnly: true to have Google check the request without sending anything.

post/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 to invite, digits only.

validateOnlyboolean

Response

Validated only (validateOnly true), nothing sent

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