ZEzernio
Ad Accounts

Invite a client account to a manager

Changed on

Invites a Google Ads account to be managed by one of your manager accounts; the link stays pending until the client accepts.

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

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

  • d568bb00ed73Revision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

  • 450ec6ec5b0eRevision changes
    • info

      added the non-success response with the status