If the specified session entity type already exists, overrides the session entity type.
This method doesn't work with Google Assistant integration. Contact Dialogflow support if you need to use session entities with Google Assistant integration.
HTTP request
POST https://{endpoint}/v2/{parent=projects/*/agent/sessions/*}/entityTypes
Required. The session to create a session entity type for. Format: projects/<Project ID>/agent/sessions/<Session ID> or projects/<Project ID>/agent/environments/<Environment ID>/users/<User ID>/
sessions/<Session ID>. If Environment ID is not specified, we assume default 'draft' environment. If User ID is not specified, we assume default '-' user.
Authorization requires the following IAM permission on the specified resource parent:
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-06-27 UTC."],[[["\u003cp\u003eThis endpoint creates a new session entity type, or overrides an existing one if it already exists.\u003c/p\u003e\n"],["\u003cp\u003eThe HTTP request is a \u003ccode\u003ePOST\u003c/code\u003e to the specified endpoint using the provided \u003ccode\u003eparent\u003c/code\u003e path parameter for session identification.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must contain an instance of \u003ccode\u003eSessionEntityType\u003c/code\u003e, and a successful response will include a new \u003ccode\u003eSessionEntityType\u003c/code\u003e instance.\u003c/p\u003e\n"],["\u003cp\u003eThis method does not support Google Assistant integration, and requires specific \u003ccode\u003edialogflow.sessionEntityTypes.create\u003c/code\u003e IAM permissions for authorization.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization for this endpoint requires one of the specified OAuth scopes: \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e or \u003ccode\u003ehttps://www.googleapis.com/auth/dialogflow\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# Method: projects.agent.sessions.entityTypes.create\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nCreates a session entity type.\n\nIf the specified session entity type already exists, overrides the session entity type.\n\nThis method doesn't work with Google Assistant integration. Contact Dialogflow support if you need to use session entities with Google Assistant integration.\n\n### HTTP request\n\n`POST https://{endpoint}/v2/{parent=projects/*/agent/sessions/*}/entityTypes`\n\nWhere `{endpoint}` is one of the [supported service endpoints](/dialogflow/es/docs/reference/rest#rest_endpoints).\n\nThe URLs use [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n### Request body\n\nThe request body contains an instance of [SessionEntityType](/dialogflow/es/docs/reference/rest/v2/projects.agent.environments.users.sessions.entityTypes#SessionEntityType).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [SessionEntityType](/dialogflow/es/docs/reference/rest/v2/projects.agent.environments.users.sessions.entityTypes#SessionEntityType).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/cloud-platform`\n- `\n https://www.googleapis.com/auth/dialogflow`\n\nFor more information, see the [Authentication Overview](/docs/authentication#authorization-gcp)."]]
