Method: customers.insert
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.
HTTP request
POST https://reseller.googleapis.com/apps/reseller/v1/customers
The URL uses gRPC Transcoding syntax.
Query parameters
| 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.
|
Request body
The request body contains an instance of Customer.
Response body
If successful, the response body contains a newly created instance of Customer.
Authorization scopes
Requires the following OAuth scope:
https://www.googleapis.com/auth/apps.order
For more information, see the Authorization guide.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-08-22 UTC.
[null,null,["Last updated 2024-08-22 UTC."],[[["Orders a new customer account, potentially transferring an existing subscription if the customer already has a Google account."],["Before ordering, check if the customer account exists to handle existing accounts correctly."],["After creation, an administrator must be provisioned for the new customer account and sign the G Suite Reseller Agreement."],["Uses the `customers.get` method to check for existing customer accounts and the `customerAuthToken` for transferring subscriptions."],["Requires authorization with the `https://www.googleapis.com/auth/apps.order` scope."]]],["This content outlines the process for ordering a new customer account via the Reseller API. Key actions include checking for an existing account using `customers.get`, using `customerAuthToken` for transferring subscriptions, and provisioning a user as an administrator post-creation. The `POST` request is made to `https://reseller.googleapis.com/apps/reseller/v1/customers`, and it uses query parameters like `customerAuthToken`. The request and response bodies both use a `Customer` instance. The `https://www.googleapis.com/auth/apps.order` scope is required.\n"]]
