Method: projects.locations.customClasses.create

Create a custom class.

HTTP request


The URL uses gRPC Transcoding syntax.

Path parameters



Required. The parent resource where this custom class will be created. Format:


Speech-to-Text supports three locations: global, us (US North America), and eu (Europe). If you are calling the endpoint, use the global location. To specify a region, use a regional endpoint with matching us or eu location value.

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

  • speech.customClasses.create

Request body

The request body contains data with the following structure:

JSON representation
  "customClassId": string,
  "customClass": {
    object (CustomClass)


Required. The ID to use for the custom class, which will become the final component of the custom class' resource name.

This value should restrict to letters, numbers, and hyphens, with the first character a letter, the last a letter or a number, and be 4-63 characters.


object (CustomClass)

Required. The custom class to create.

Response body

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

Authorization Scopes

Requires the following OAuth scope:


For more information, see the Authentication Overview.