Customers: insert

Requires authorization

Order a new customer's account. Try it now.

Before ordering a new customer account, establish whether the customer account already exists using the customers.get method.

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.


HTTP request



Parameter name Value Description
Optional query parameters
customerAuthToken string 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.


This request requires authorization with the following scope (read more about authentication and authorization).


Request body

In the request body, supply a Customers resource.


If successful, this method returns a Customers resource in the response body.

Try it!

Use the APIs Explorer below to call this method on live data and see the response. Alternatively, try the standalone Explorer.