Method: projects.serviceAccounts.create

Creates a ServiceAccount.

HTTP request

POST https://iam.googleapis.com/v1/{name=projects/*}/serviceAccounts

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
name

string

Required. The resource name of the project associated with the service accounts, such as projects/my-project-123.

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

  • iam.serviceAccounts.create

Request body

The request body contains data with the following structure:

JSON representation
{
  "accountId": string,
  "serviceAccount": {
    object (ServiceAccount)
  }
}
Fields
accountId

string

Required. The account id that is used to generate the service account email address and a stable unique id. It is unique within a project, must be 6-30 characters long, and match the regular expression [a-z]([-a-z0-9]*[a-z0-9]) to comply with RFC1035.

serviceAccount

object (ServiceAccount)

The ServiceAccount resource to create. Currently, only the following values are user assignable: displayName and description.

Response body

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

Authorization scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/iam
  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.