Method: projects.locations.agents.create

Creates an agent in the specified location.

Note: You should always train a flow prior to sending it queries. See the training documentation.

HTTP request

POST https://{endpoint}/v3beta1/{parent=projects/*/locations/*}/agents

Where {endpoint} is one of the supported service endpoints.

The URLs use gRPC Transcoding syntax.

Path parameters



Required. The location to create a agent for. Format: projects/<Project ID>/locations/<Location ID>.

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

  • dialogflow.agents.create

Request body

The request body contains an instance of Agent.

Response body

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

Authorization scopes

Requires one of the following OAuth scopes:


For more information, see the Authentication Overview.