Method: locations.workforcePools.create

Creates a newWorkforcePool.

You cannot reuse the name of a deleted pool until 30 days after deletion.

HTTP request

POST https://iam.googleapis.com/v1/{location=locations/*}/workforcePools

The URL usesgRPC Transcoding syntax.

Path parameters

Parameters
location

string

Optional. The location of the pool to create.

Format:locations/{location}.

Query parameters

Parameters
workforcePoolId

string

Optional. The ID to use for the pool, which becomes the final component of the resource name. The IDs must be a globally unique string of 6 to 63 lowercase letters, digits, or hyphens. It must start with a letter, and cannot have a trailing hyphen. The prefixgcp- is reserved for use by Google, and may not be specified.

Request body

The request body contains an instance ofWorkforcePool.

Response body

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

Authorization scopes

Requires one of the following OAuth scopes:

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

For more information, see theAuthentication Overview.

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-05-21 UTC.