---
title: "Create a chatActivityReason"
method: POST
path: "/chatActivitiesReasons"
tags: ["chatActivitiesReasons"]
---

# Create a chatActivityReason

`POST /chatActivitiesReasons`

## Request

- Base URL: `https://api.lumahealth.io/api/v2`
- URL: `https://api.lumahealth.io/api/v2/chatActivitiesReasons`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/lumahealth/apis/rest-service/docs/chatActivitiesReasons/post.ts> (a function with typed inputs; its response is checked against the schema)

## Request body

- ChatActivityReasonRequestCreate
  - `text` object, required: Both the original and the lower-case space-free normalized version of the reason to close a chat
    - `original` string, required: The original text of the reason to close a chat
    - `normalized` unknown, required
  - `allowDescription` boolean, required: Indicator if this reason requires an extra description or not. The extra description lives in the chatActivity itself, not here.

## Response `201`

Successful creation

- ChatActivityReasonResponse: A ChatActivityReason represents a predefined reason or category that staff can attach to a chat activity or conversation, such as why it was closed or flagged. It stores both the original text and a normalized version for consistent matching, plus a flag indicating whether an additional free text description is allowed alongside the selected reason. This is used to standardize and report on why patient chat conversations occur or end.
  - `_id` string: Luma's internal ID of an object.
  - `user` string: The ID of the root account user.
  - `deleted` 0 | 1: Flag for logical deletion where 1 means deleted.
  - `createdBy` string: The ID of the user who created this object.
  - `updatedBy` string: The ID of the user who updated this object.
  - `createdAt` string, date-time: The date/time when this object was created.
  - `updatedAt` string, date-time: The date/time when this object was updated.
  - `text` object, required: Both the original and the lower-case space-free normalized version of the reason to close a chat
    - `original` string, required: The original text of the reason to close a chat
    - `normalized` unknown, required
  - `allowDescription` boolean, required: Indicator if this reason requires an extra description or not. The extra description lives in the chatActivity itself, not here.

## Other responses

- `401`: Not authenticated
- `403`: Access token does not have the required scope
- `default`: Unexpected error

---

[API](https://skmtc.dev/lumahealth/apis/rest-service.md) - [All operations](https://skmtc.dev/lumahealth/apis/rest-service/llms.txt) - [OpenAPI document](https://skmtc.dev/lumahealth/apis/rest-service/revisions/f19aeba84a26?raw)