---
title: "Log a new Client Communication history"
method: POST
path: "/api/v1/client-communications"
tags: ["Client Communication"]
---

# Log a new Client Communication history

`POST /api/v1/client-communications`

Manually register a new communication between a Clinic and a PetParent

## Request body

- object
  - `user_id` integer — Id of the PetParent that the Clinic communicates to.
  - `patient_ids` integer[] — Id of the patients related to the communication.
  - `clinic_id` integer — Id of the Clinic from where the communication is made from.
  - `channel` 'phone' | 'other' — The channel of the communication. Enum. One of phone, other, sms, email. API limited only to phone & other.
  - `subject` string — The subject of communication.
  - `content` string — The content of communication. (required for email)
  - `destination` string — Where the communication is sent to ( only for sms/email/phone ).
  - `communicated_at` string — The communicated_at when the communication was made.
  - `message_id` string — The id used for identifying attachments when channel is mail.

## Response `201`

successful operation

- object
  - `data` object
    - `type` string
    - `subject` string
    - `content` string, nullable
    - `communicated_at` string
    - `replied_to_id` integer, nullable — Id of the root communication this is a reply to.
    - `last_reply_at` string, nullable — Timestamp of the last reply in the thread (only on root communications).
    - `replies` Data[] — List of replies to this communication (when included). — unresolved $ref

## Other responses

- `400` — unresolved $ref
- `401` — unresolved $ref
- `403` — unresolved $ref
- `422` — unresolved $ref
- `429` — unresolved $ref

---

[API](https://skmtc.net/digitail/apis/digitail-api.md) · [All operations](https://skmtc.net/digitail/apis/digitail-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/digitail/digitail-api/revisions/bd9694db5fce/schema)