Sign in

v1

latestOpenAPI 3.0.0Creative Commons Attribution 3.02026-07-1346141211.8 KB
accounts

Creates a new Customer resource under the reseller or distributor account. Possible error codes: * PERMISSION_DENIED: * The reseller account making the request is different from the reseller account in the API request. * You are not authorized to create a customer. See https://support.google.com/channelservices/answer/9759265 * INVALID_ARGUMENT: * Required request parameters are missing or invalid. * Domain field value doesn't match the primary email domain. Return value: The newly created Customer resource.

post/v1/{+parent}/customers

Path parameters

parentstring required

Required. The resource name of reseller account in which to create the customer. Parent uses the format: accounts/{account_id}

Request body

createTimestring google-datetime

Output only. Time when the customer was created.

customerAttestationState'CUSTOMER_ATTESTATION_STATE_UNSPECIFIED' | 'EXEMPT' | 'NON_EXEMPT_AND_INFO_VERIFIED'

Optional. Indicate if a customer is attesting about the correctness of provided information. Only required if creating a GCP Entitlement. NOTE: This field will be mandatory for all new GCP customers starting Aug 31st, 2026 and this field will also be required for all existing customers purchasing new GCP Entitlements.

cloudIdentityIdstring

Output only. The customer's Cloud Identity ID if the customer has a Cloud Identity resource.

orgDisplayNamestring

Required. Name of the organization that the customer entity represents.

updateTimestring google-datetime

Output only. Time when the customer was updated.

correlationIdstring

Optional. External CRM ID for the customer. Populated only if a CRM ID exists for this customer.

languageCodestring

Optional. The BCP-47 language code, such as "en-US" or "sr-Latn". For more information, see https://www.unicode.org/reports/tr35/#Unicode_locale_identifier.

channelPartnerIdstring

Cloud Identity ID of the customer's channel partner. Populated only if a channel partner exists for this customer.

alternateEmailstring

Secondary contact email. You need to provide an alternate email to create different domains if a primary contact email already exists. Users will receive a notification with credentials when you create an admin.google.com account. Secondary emails are also recovery email addresses. Alternate emails are optional when you create Team customers.

domainstring

Required. The customer's primary domain. Must match the primary contact email's domain.

namestring

Output only. Resource name of the customer. Format: accounts/{account_id}/customers/{customer_id}

Response

Successful response