---
title: "Create Chat"
method: POST
path: "/comms/chat/create"
tags: ["provider", "comms"]
---

# Create Chat

`POST /comms/chat/create`

Creates a chat for a given Patient

## Headers

- `TENANT` string, required
- `API-KEY` string, required

## Request body

- ChatCreate
  - `primaryPatientId` string, required
  - `phoneNumber` string, required
  - `status` 'READ' | 'UNREAD'

## Response `200`

Successful Response

- ChatSummary
  - `id` string, required
  - `primaryPatientId` string, nullable, required
  - `status` 'READ' | 'UNREAD', required
  - `patients` ChatPatient[], required
    - `id` string, required
    - `firstName` string, nullable, required
    - `lastName` string, nullable, required
    - `primaryLocationId` string, nullable, required
  - `phoneNumber` string, required
  - `latestMessageContent` string, nullable
  - `latestMessageDate` string, date-time, nullable
  - `createdDate` string, date-time, required
  - `optedOutOfSms` boolean, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/decodahealth/apis/decoda-api.md) · [All operations](https://skmtc.dev/decodahealth/apis/decoda-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/decodahealth/decoda-api/revisions/4939a65a89d2/schema)