Method: domains.create

Full name:

Creates a Microsoft AD domain.

HTTP request


The URL uses gRPC Transcoding syntax.

Path parameters



Required. The resource project name and location using the form: projects/{projectId}/locations/global

Authorization requires the following IAM permission on the specified resource parent:


Query parameters



Required. The fully qualified domain name. e.g., with the following restrictions:

  • Must contain only lowercase letters, numbers, periods and hyphens.
  • Must start with a letter.
  • Must contain between 2-64 characters.
  • Must end with a number or a letter.
  • Must not start with period.
  • First segement length (mydomain form example above) shouldn't exceed 15 chars.
  • The last segment cannot be fully numeric.
  • Must be unique within the customer project.

Request body

The request body contains an instance of Domain.

Response body

If successful, the response body contains a newly created instance of Operation.

Authorization Scopes

Requires the following OAuth scope:


For more information, see the Authentication Overview.