---
title: "Send a chat message"
method: POST
path: "/cases/{id}/chats"
tags: ["Cases"]
---

# Send a chat message

`POST /cases/{id}/chats`

Posts a new chat message on a case, visible to both you and the collection partner.

**Message Details:**
- The message is attributed to the team member identified by `userId`
- The collection partner will receive an email notification about the new message
- Messages appear in the case chat timeline in chronological order

**Prerequisites:**
- The case must exist and belong to your account
- The `userId` must be a valid user ID from `GET /users` belonging to your team

**Use Case:**
Use this endpoint to communicate with collection partners about case progress, provide additional information, or respond to partner questions. Messages sent via this endpoint are equivalent to messages sent through the creditor portal chat.

## Path parameters

- `id` string, uuid, required

## Request body

- DebituraWebExternalApiContractsV1ChatsSendChatRequest — Request to send a chat message on a case.
  - `message` string, required — The chat message content to send.
  - `userId` string, uuid, nullable — ID of the team member sending this message. Must be a valid user ID from GET /users belonging to your team. Deprecated: use UserEmail instead. At least one of UserId or UserEmail must be provided.
  - `userEmail` string, email, nullable — Email address of the team member sending this message. Must correspond to an active member of your team (same account as the API key). Preferred over UserId. At least one of UserEmail or UserId must be provided.

## Response `200`

Chat message sent successfully

- DebituraWebExternalApiContractsV1ChatsChatDto
  - `id` string, uuid
  - `dateCreated` string, date-time
  - `dateUpdated` string, date-time, nullable
  - `role` 0 | 1 | 2
  - `roleLabel` string, nullable — Human-readable label for the role (e.g., "Partner", "Creditor", "Managed by partner"). Companion to Debitura.Web.ExternalApi.Contracts.V1.Chats.ChatDto.Role — always present when Role is set.
  - `message` string, nullable
  - `isSeen` boolean
  - `user` DebituraWebExternalApiContractsV1UsersUserRelationDto
    - `id` integer
    - `dateCreated` string, date-time, nullable
    - `dateUpdated` string, date-time, nullable
    - `firstName` string, nullable
    - `lastName` string, nullable
    - `email` string, nullable, required

## Other responses

- `400` — Validation error — missing fields, invalid userId, or invalid request body
- `404` — Case not found
- `500` — Internal server error

---

[API](https://skmtc.net/debitura/apis/debitura-customer-api.md) · [All operations](https://skmtc.net/debitura/apis/debitura-customer-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/debitura/debitura-customer-api/versions/46478f2e476f/schema)