> ## Documentation Index
> Fetch the complete documentation index at: https://developer.vetcove.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create an imported conversation

> 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.



## OpenAPI

````yaml post /ext/v2/imported-conversations/
openapi: 3.1.0
info:
  description: ''
  title: NinjaAPI
  version: 2.0.0
servers:
  - url: https://connect.vetcove.com/
security: []
paths:
  /ext/v2/imported-conversations/:
    post:
      tags:
        - Inbox
      summary: Create an imported conversation
      description: >-
        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.
      operationId: imported_conversations_create
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateImportedConversationRequestSchema'
        required: true
      responses:
        '201':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExternalImportedConversationSchema'
          description: Created
      security:
        - ExternalAPIAuth: []
components:
  schemas:
    CreateImportedConversationRequestSchema:
      description: Schema for creating an imported conversation via the Connect API.
      properties:
        attachment_uploaded_file_ids:
          description: >-
            IDs of files previously uploaded via `POST /file-uploads/` that
            belong to this conversation.
          items:
            type: integer
          title: Attachment Uploaded File Ids
          type: array
        clinic_client_id:
          description: The ID of the clinic client (pet parent) the conversation is about.
          title: Clinic Client Id
          type: integer
        clinic_patient_id:
          anyOf:
            - type: integer
            - type: 'null'
          description: >-
            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.
          title: Clinic Patient Id
        text:
          description: >-
            The full conversation transcript, stored and rendered verbatim in
            the Vetcove patient timeline.
          minLength: 1
          title: Text
          type: string
        title:
          anyOf:
            - maxLength: 255
              type: string
            - type: 'null'
          description: Short label shown in the patient timeline preview row.
          title: Title
      required:
        - clinic_client_id
        - text
      title: CreateImportedConversationRequestSchema
      type: object
    ExternalImportedConversationSchema:
      properties:
        attachment_uploaded_file_ids:
          description: >-
            IDs of uploaded files attached to this conversation. Clients fetch
            the underlying file bytes via the `/file-uploads/` endpoints.
          items:
            type: integer
          title: Attachment Uploaded File Ids
          type: array
        clinic_client_id:
          description: The ID of the clinic client (pet parent) the conversation is about.
          title: Clinic Client Id
          type: integer
        clinic_id:
          description: The ID of the clinic the conversation belongs to.
          title: Clinic Id
          type: integer
        clinic_patient_ids:
          description: >-
            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.
          items:
            type: integer
          title: Clinic Patient Ids
          type: array
        created:
          description: The datetime this object was created.
          format: date-time
          title: Created
          type: string
        id:
          description: The ID of the imported conversation record.
          title: Id
          type: integer
        modified:
          description: >-
            The datetime this object was last modified; changes to related
            entities will not update this field.
          format: date-time
          title: Modified
          type: string
        text:
          description: >-
            The full conversation transcript, stored and rendered verbatim in
            the Vetcove patient timeline.
          title: Text
          type: string
        title:
          anyOf:
            - type: string
            - type: 'null'
          description: Short label shown in the patient timeline preview row.
          title: Title
      required:
        - created
        - modified
        - id
        - clinic_id
        - clinic_client_id
        - clinic_patient_ids
        - title
        - text
        - attachment_uploaded_file_ids
      title: ExternalImportedConversationSchema
      type: object
  securitySchemes:
    ExternalAPIAuth:
      scheme: bearer
      type: http

````