---
title: "Create Interaction"
method: POST
path: "/interactions/"
tags: ["Interactions"]
---

# Create Interaction

`POST /interactions/`

Creates a new interaction.

## Headers

- `Tenant-Name` string, required — Identifies a distinct entity within Corti's multi-tenant system. Ensures correct routing and authentication of the request.

## Request body

- InteractionsCreateRequest
  - `assignedUserId` string, uuid
  - `encounter` InteractionsEncounterCreateRequest, required
    - `identifier` string, required — A unique identifier for the encounter, essential for tracking and referencing specific patient interactions.
    - `status` 'planned' | 'in-progress' | 'on-hold' | 'completed' | 'cancelled' | 'deleted', required
    - `type` 'first_consultation' | 'consultation' | 'emergency' | 'inpatient' | 'outpatient', required
    - `period` InteractionsEncounterPeriod
      - `startedAt` string, date-time, required — The start date/time of the encounter. (UTC)
      - `endedAt` string, date-time, nullable — The end date/time of the encounter. (UTC)
    - `title` string, nullable — A readable name for the interaction
  - `patient` InteractionsPatient
    - `identifier` string, required — FHIR reference to patient identifier.
    - `name` string, nullable — FHIR reference to Text representation of the full name.
    - `gender` 'male' | 'female' | 'unknown' | 'other'
    - `birthDate` string, date-time, nullable — FHIR reference to patient birth date.
    - `pronouns` string, nullable — FHIR reference to patient extension Individual Pronouns.

## Response `201`

Returns the newly created interaction with its assigned ID and WebSocket URL for real-time data streaming.

- InteractionsCreateResponse
  - `interactionId` string, uuid, required
  - `websocketUrl` string, required — WebSocket URL for streaming real-time interactions. Append a token in the format: /interactions/{interactionID}/streams?token=Bearer token-value-here

## Other responses

- `400` — RFC9457
- `403` — RFC9457
- `500` — RFC9457
- `504` — RFC9457

---

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