Sign in

v1

latestOpenAPI 3.0.0Creative Commons Attribution 3.02026-07-13171054.0 KB
customers

Orders a new customer's account. Before ordering a new customer account, establish whether the customer account already exists using the customers.get If the customer account exists as a direct Google account or as a resold customer account from another reseller, use the customerAuthToken\ as described in order a resold account for an existing customer. For more information about ordering a new customer account, see order a new customer account. After creating a new customer account, you must provision a user as an administrator. The customer's administrator is required to sign in to the Admin console and sign the G Suite via Reseller agreement to activate the account. Resellers are prohibited from signing the G Suite via Reseller agreement on the customer's behalf. For more information, see order a new customer account.

post/apps/reseller/v1/customers

Query parameters

customerAuthTokenstring

The customerAuthToken query string is required when creating a resold account that transfers a direct customer's subscription or transfers another reseller customer's subscription to your reseller management. This is a hexadecimal authentication token needed to complete the subscription transfer. For more information, see the administrator help center.

Request body

customerDomainstring

The customer's primary domain name string. customerDomain is required when creating a new customer. Do not include the www prefix in the domain when adding a customer.

customerType'customerTypeUnspecified' | 'domain' | 'team'

Identifies the type of the customer. Acceptable values include: * domain: Implies a domain-verified customer (default). * team: Implies an email-verified customer. For more information, see managed teams.

customerDomainVerifiedboolean

Whether the customer's primary domain has been verified.

kindstring

Identifies the resource as a customer. Value: reseller#customer

customerIdstring

This property will always be returned in a response as the unique identifier generated by Google. In a request, this property can be either the primary domain or the unique identifier generated by Google.

alternateEmailstring

Like the "Customer email" in the reseller tools, this email is the secondary contact used if something happens to the customer's service such as service outage or a security issue. This property is required when creating a new "domain" customer and should not use the same domain as customerDomain. The alternateEmail field is not necessary to create a "team" customer.

resourceUiUrlstring

URL to customer's Admin console dashboard. The read-only URL is generated by the API service. This is used if your client application requires the customer to complete a task in the Admin console.

phoneNumberstring

Customer contact phone number. Must start with "+" followed by the country code. The rest of the number can be contiguous numbers or respect the phone local format conventions, but it must be a real phone number and not, for example, "123". This field is silently ignored if invalid.

Response

Successful response