Before you create a new customer account, consider the following:
Create a customer account
To create a customer account, use the following
POST
request and
include the authorization token:
POST https://reseller.googleapis.com/apps/reseller/v1/customers
Within the new customer's account,
create a user
.
If the response returns an HTTP
409 Conflict
status code, the
customerId
already exists. Before registering the customer account, you must
transfer the customer's subscriptions
.
If applicable,
change the customer's default launguage
.
Promote the
user to the super administrator role
.
When creating the administrator account, you can either generate a temporary
random password or prompt the customer to provide a password.
Notify the customer that they must sign-in to the Admin console and
sign the Google Workspace via Reseller agreement in order to activate
their account. Resellers are prohibited from signing the Terms of Service on
the customer's behalf.
Types of customers
You can create two kinds of customers on Google Workspace:
- Domain-verified customers
. These customers need Gmail and need
full administrator access. When you create this type of customer, set the
customerType
to
domain
.
- Email-verified customers
. These customers don't own or manage their
domain. When you create this type of customer, set the
customerType
to
team
. These type of customers can purchase the
Essentials and Enterprise Essentials
editions of Google Workspace.
The following JSON request body is an example of a domain-verified customer:
{
"customerDomain": "
DOMAIN_NAME
",
"customerType": "domain",
"postalAddress": {
"contactName": "
NAME
",
"organizationName": "
ORGANIZATION_NAME
",
"postalCode": "
POSTAL_CODE
",
"countryCode": "
COUNTRY_CODE
"
},
"alternateEmail": "
EMAIL_ADDRESS
"
}
Replace the following:
DOMAIN_NAME
: your customer's domain?for example,
example.com
NAME
: your customer's name?for example,
Alex Cruz
.
ORGANIZATION_NAME
: your customer's organization
name?for example,
Example Organization
.
POSTAL_CODE
: your customer's ZIP or postal code?for
example,
94043
.
COUNTRY_CODE
: your customer's 2 character
ISO country code
.
EMAIL_ADDRESS
: your customer's email address?for
example,
cruz@example.com
.
A successful response returns an HTTP
200
status code and the new customer's
information:
{
"kind": "reseller#customer",
"customerId": "
CUSTOMER_ID
",
"customerDomain": "
DOMAIN_NAME
",
"customerType": "domain",
"postalAddress": {
"kind": "customers#address",
"contactName": "
NAME
",
"organizationName": "
ORGANIZATION_NAME
",
"postalCode": "
POSTAL_CODE
",
"countryCode": "
COUNTRY_CODE
",
},
"alternateEmail": "
EMAIL_ADDRESS
"
}
The following JSON request body is an example of an email-verified customer:
{
"customerDomain": "
DOMAIN_NAME
",
"customerType": "team",
"primaryAdmin": {
"primaryEmail": "
EMAIL_ADDRESS
"
},
"postalAddress": {
"contactName": "
NAME
",
"organizationName": "
ORGANIZATION_NAME
",
"postalCode": "
POSTAL_CODE
",
"countryCode": "
COUNTRY_CODE
"
},
"alternateEmail": "
EMAIL_ADDRESS
"
}
A successful response returns an HTTP
200
status code and the new customer's
information:
{
"kind": "reseller#customer",
"customerId": "
CUSTOMER_ID
",
"customerDomain": "
DOMAIN_NAME
,
"customerType": "team",
"primaryAdmin": {
"primaryEmail": "
EMAIL_ADDRESS
"
},
"postalAddress": {
"kind": "customers#address",
"contactName": "
NAME
",
"organizationName": "
ORGANIZATION_NAME
",
"postalCode": "
POSTAL_CODE
",
"countryCode": "
COUNTRY_CODE
",
},
"alternateEmail": "
EMAIL_ADDRESS
"
}
Change a customer's default language
A customer's default language is only applied to
new
users when they're
created. Existing users retain their current language even after you
update the default language. Therefore, you must set the customer default
language before you create any users.
A newly created customer has a default language of English. To change the
default language, use the
PATCH
or
UPDATE
calls from the Directory API
Customers
endpoint.
Use the Directory API to update the default
language
value for a customer:
PATCH https://reseller.googleapis.com/admin/directory/v1/customers/
CUSTOMER_ID
Include the following JSON request body:
{
"language":"
LANGUAGE_CODE
"
}
Replace the following:
CUSTOMER_ID
: a unique identifier for your
customer?for example,
C0123456
LANGUAGE_CODE
: an accepted
language code
?for example,
es
for Spanish.
A successful JSON response returns an HTTP
200
status code and the updated
customer resource:
{
"alternateEmail": "
EMAIL_ADDRESS
",
"customerCreationTime": "2022-12-12T23:04:10.620Z",
"customerDomain": "
DOMAIN_NAME
",
"id": "
CUSTOMER_ID
",
"kind": "admin#directory#customer",
"language": "
LANGUAGE_CODE
",
"postalAddress": {
"contactName": "
NAME
",
"countryCode": "
COUNTRY_CODE
",
"organizationName": "
ORGANIZATION_NAME
",
"postalCode": "
POSTAL_CODE
"
}
}
Next steps