CreateCustomerClient

Page Summary

• 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.

gRPC REST

• HTTP request
• Path parameters
• Request body
  • JSON representation
• Response body
  • JSON representation
• Authorization scopes
• Try it!

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
invitationLink	string Link for inviting user to access the created customer. Accessible to allowlisted customers only.
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.