---
title: "POST /v1/{+customer}:provisionCloudIdentity"
method: POST
path: "/v1/{+customer}:provisionCloudIdentity"
tags: ["accounts"]
---

# POST /v1/{+customer}:provisionCloudIdentity

`POST /v1/{+customer}:provisionCloudIdentity`

Creates a Cloud Identity for the given customer using the customer's information, or the information provided here. Possible error codes: * PERMISSION_DENIED: * The customer doesn't belong to the reseller. * You are not authorized to provision cloud identity id. See https://support.google.com/channelservices/answer/9759265 * INVALID_ARGUMENT: Required request parameters are missing or invalid. * NOT_FOUND: The customer was not found. * ALREADY_EXISTS: The customer's primary email already exists. Retry after changing the customer's primary contact email. * INTERNAL: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support. * UNKNOWN: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support. Return value: The ID of a long-running operation. To get the results of the operation, call the GetOperation method of CloudChannelOperationsService. The Operation metadata contains an instance of OperationMetadata.

## Path parameters

- `customer` string, required

## Request body

- GoogleCloudChannelV1ProvisionCloudIdentityRequest — Request message for CloudChannelService.ProvisionCloudIdentity
  - `cloudIdentityInfo` GoogleCloudChannelV1CloudIdentityInfo — Cloud Identity information for the Cloud Channel Customer.
    - `alternateEmail` string — The alternate email.
    - `customerType` 'CUSTOMER_TYPE_UNSPECIFIED' | 'DOMAIN' | 'TEAM' — CustomerType indicates verification type needed for using services.
    - `languageCode` string — Language code.
    - `primaryDomain` string — Output only. The primary domain name.
    - `phoneNumber` string — Phone number associated with the Cloud Identity.
    - `isDomainVerified` boolean — Output only. Whether the domain is verified. This field is not returned for a Customer's cloud_identity_info resource. Partners can use the domains.get() method of the Workspace SDK's Directory API, or listen to the PRIMARY_DOMAIN_VERIFIED Pub/Sub event in to track domain verification of their resolve Workspace customers.
    - `adminConsoleUri` string — Output only. URI of Customer's Admin console dashboard.
    - `eduData` GoogleCloudChannelV1EduData — Required Edu Attributes
      - `website` string — Web address for the edu customer's institution.
      - `instituteSize` 'INSTITUTE_SIZE_UNSPECIFIED' | 'SIZE_1_100' | 'SIZE_101_500' | 'SIZE_501_1000' | 'SIZE_1001_2000' | 'SIZE_2001_5000' | 'SIZE_5001_10000' | 'SIZE_10001_OR_MORE' — Size of the institute.
      - `instituteType` 'INSTITUTE_TYPE_UNSPECIFIED' | 'K12' | 'UNIVERSITY' — Designated institute type of customer.
  - `user` GoogleCloudChannelV1AdminUser — Information needed to create an Admin User for Google Workspace.
    - `email` string — Primary email of the admin user.
    - `givenName` string — Given name of the admin user.
    - `familyName` string — Family name of the admin user.
  - `validateOnly` boolean — Validate the request and preview the review, but do not post it.

## Response `200`

Successful response

---

[API](https://skmtc.net/google/apis/cloudchannel.md) · [All operations](https://skmtc.net/google/apis/cloudchannel/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/cloudchannel/versions/7477d1d5f236/schema)