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/*/locations/*/agent/environments/*/users/*/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 webpage outlines how to create a session entity type using a POST HTTP request to a specific endpoint, with the option to override an existing type.\u003c/p\u003e\n"],["\u003cp\u003eThe creation requires a \u003ccode\u003eparent\u003c/code\u003e path parameter specifying the session and authorization via the \u003ccode\u003edialogflow.sessionEntityTypes.create\u003c/code\u003e IAM permission.\u003c/p\u003e\n"],["\u003cp\u003eThe request body should include an instance of \u003ccode\u003eSessionEntityType\u003c/code\u003e, with the successful response containing a newly created \u003ccode\u003eSessionEntityType\u003c/code\u003e instance.\u003c/p\u003e\n"],["\u003cp\u003eThis function does not work with Google Assistant integration, and Dialogflow support should be contacted if such integration is necessary.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization for this action requires one of two OAuth scopes, either \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.locations.agent.environments.users.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/*/locations/*/agent/environments/*/users/*/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)."]]
