customers

POST /v23/customers/{customersId}:createCustomerClient

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

Request

  • Base URL
    https://searchads360.googleapis.com
  • Auth
    OAuth 2 and OAuth 2
    Implicithttps://accounts.google.com/o/oauth2/auth
    Scopeshttps://www.googleapis.com/auth/doubleclicksearch
    Authorization codehttps://accounts.google.com/o/oauth2/auth
    Token URLhttps://accounts.google.com/o/oauth2/token
    Scopeshttps://www.googleapis.com/auth/doubleclicksearch
  • TypeScript
    A function with typed inputs. Its response is checked against the schema.

Path parameters

customersIdstring required

Request body

accessRole'UNSPECIFIED' | 'UNKNOWN' | 'ADMIN' | 'STANDARD' | 'READ_ONLY' | 'EMAIL_ONLY'

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

emailAddressstring

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

validateOnlyboolean

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

Response

Successful response

invitationLinkstring

Link for inviting user to access the created customer. Accessible to allowlisted customers only.

resourceNamestring

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

Changes

No recorded changes to this operation across all 4 revisions of this API.