CreateCustomerClient

  • The CreateCustomerClient RPC call creates a new client under a manager account and returns the new client customer.

  • This method can throw various errors including AuthenticationError, AuthorizationError, and QuotaError.

  • Using this method requires the https://www.googleapis.com/auth/adwords OAuth scope.

Creates a new client under manager. The new client customer is returned.

List of thrown errors: AccessInvitationError AuthenticationError AuthorizationError CurrencyCodeError HeaderError InternalError ManagerLinkError QuotaError RequestError StringLengthError TimeZoneError

HTTP request

POST https://googleads.googleapis.com/v22/customers/{customerId}:createCustomerClient

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
customerId

string

Required. The ID of the Manager under whom client customer is being created.

Request body

The request body contains data with the following structure:

JSON representation 
{
  "customerClient": {
    object (Customer)
  },
  "accessRole": enum (AccessRole),
  "validateOnly": boolean,
  "emailAddress": string
}
Fields
accessRole

enum (AccessRole)

The proposed role of user on the created client customer. Accessible only to customers on the allow-list.
customerClient

object (Customer)

Required. The new client customer to create. The resource name on this customer will be ignored.
emailAddress

string

Email address of the user who should be invited on the created client customer. Accessible only to customers on the allow-list.
validateOnly

boolean

If true, the request is validated but not executed. Only errors are returned, not results.

Response body

Response message for customers.createCustomerClient mutate.

If successful, the response body contains data with the following structure:

JSON representation 
{
  "resourceName": string,
  "invitationLink": string
}
Fields
resourceName

string

The resource name of the newly created customer. Customer resource names have the form: customers/{customerId}.
Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/adwords

For more information, see the OAuth 2.0 Overview.