---
title: "Create an imported conversation"
method: POST
path: "/ext/v2/imported-conversations/"
tags: ["Inbox"]
---

# Create an imported conversation

`POST /ext/v2/imported-conversations/`

## Request

- Base URL: `https://connect.vetcove.com`
- URL: `https://connect.vetcove.com/ext/v2/imported-conversations/`
- Auth: HTTP bearer

Writes a completed conversation transcript back into Vetcove so that it surfaces on the clinic's patient timelines.

Attachments must be uploaded via `POST /file-uploads/` before creating the conversation.

An **imported conversation** is a read-only transcript of a completed conversation (typically SMS) written back into Vetcove from a partner communications platform.

Imported conversations do not appear in the Vetcove inbox. They surface on the patient timeline so clinic staff can read prior client outreach alongside the rest of the patient record. When a conversation is submitted without a patient, it is attached to every active patient of the clinic client so that it appears on each of their timelines.

## Request body

- CreateImportedConversationRequestSchema: Schema for creating an imported conversation via the Connect API.
  - `attachment_uploaded_file_ids` integer[]: IDs of files previously uploaded via `POST /file-uploads/` that belong to this conversation.
  - `clinic_client_id` integer, required: The ID of the clinic client (pet parent) the conversation is about.
  - `clinic_patient_id` integer, nullable: The ID of the clinic patient the conversation is about. When omitted, the conversation is attached to every active patient of the clinic client so that it surfaces on every one of the client's patient timelines.
  - `text` string, required: The full conversation transcript, stored and rendered verbatim in the Vetcove patient timeline.
  - `title` string, nullable: Short label shown in the patient timeline preview row.

## Response `201`

Created

- ExternalImportedConversationSchema
  - `attachment_uploaded_file_ids` integer[], required: IDs of uploaded files attached to this conversation. Clients fetch the underlying file bytes via the `/file-uploads/` endpoints.
  - `clinic_client_id` integer, required: The ID of the clinic client (pet parent) the conversation is about.
  - `clinic_id` integer, required: The ID of the clinic the conversation belongs to.
  - `clinic_patient_ids` integer[], required: The IDs of the clinic patients the conversation is attached to. Conversations submitted without a patient are fanned out to every active patient of the client at ingest time.
  - `created` string, date-time, required: The datetime this object was created.
  - `id` integer, required: The ID of the imported conversation record.
  - `modified` string, date-time, required: The datetime this object was last modified; changes to related entities will not update this field.
  - `text` string, required: The full conversation transcript, stored and rendered verbatim in the Vetcove patient timeline.
  - `title` string, nullable, required: Short label shown in the patient timeline preview row.

---

[API](https://skmtc.dev/vetcove/apis/ninjaapi.md) - [All operations](https://skmtc.dev/vetcove/apis/ninjaapi/llms.txt) - [OpenAPI document](https://skmtc.dev/vetcove/apis/ninjaapi/revisions/4ceaed956e15?raw)