VEvetcove
Inbox

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.

post/ext/v2/imported-conversations/

Request

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

Request body

attachment_uploaded_file_idsinteger[]

IDs of files previously uploaded via POST /file-uploads/ that belong to this conversation.

clinic_client_idinteger required

The ID of the clinic client (pet parent) the conversation is about.

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

textstring required

The full conversation transcript, stored and rendered verbatim in the Vetcove patient timeline.

titlestring nullable

Short label shown in the patient timeline preview row.

Response

Created

attachment_uploaded_file_idsinteger[] required

IDs of uploaded files attached to this conversation. Clients fetch the underlying file bytes via the /file-uploads/ endpoints.

clinic_client_idinteger required

The ID of the clinic client (pet parent) the conversation is about.

clinic_idinteger required

The ID of the clinic the conversation belongs to.

clinic_patient_idsinteger[] 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.

createdstring date-time required

The datetime this object was created.

idinteger required

The ID of the imported conversation record.

modifiedstring date-time required

The datetime this object was last modified; changes to related entities will not update this field.

textstring required

The full conversation transcript, stored and rendered verbatim in the Vetcove patient timeline.

titlestring nullable required

Short label shown in the patient timeline preview row.

Changes

No recorded changes to this operation across all 1 revision of this API.