---
title: "Creates an ambient session."
method: POST
path: "/api/v1/ambient/session/create"
tags: ["/api/v1/ambient/session"]
---

# Creates an ambient session.

`POST /api/v1/ambient/session/create`

Creates a new ambient session for patient encounter documentation. Returns an `ambient_session_id` to use in context, streaming, status, and content APIs. Both request body fields are optional; Suki generates any values you omit.

## Headers

- `sdp_provider_id` string

## Request body

- ControllersCreateSessionRequest — Optional session identifiers for Ambient session create. Pass `emr_encounter_id` to enable cross-modality interoperability.
  - `ambient_session_id` string — **Optional** - UUID for this Ambient session. Suki generates one when omitted and returns it in the response.
  - `emr_encounter_id` string — **Optional** - UUID for your EMR or EHR visit. Pass this when you want the same Ambient note to work across APIs and SDKs. Required for cross-modality Ambient workflows.
  - `encounter_id` string — **Optional** - Session group ID that groups Ambient sessions under one note. Pass the same value when you continue or re-ambient a note. Up to 255 characters. If omitted on the first session, Suki generates one.
  - `multilingual` boolean — **Deprecated.** Multilingual support is enabled by default for all Ambient sessions.

## Response `201`

Resource created successfully.

- ControllersCreateSessionResponse — Identifiers returned after Ambient session create.
  - `ambient_session_id` string — UUID for the created Ambient session. Store this for later session API calls.
  - `composition_id` string — ID of the note for this session. Pass this value as `note_id` when you call the note-level Ambient APIs.

## Other responses

- `400` — Bad request. The request body or parameters failed validation.
- `401` — Unauthorized. The Suki access token is missing, expired, or invalid.
- `500` — Internal server error.

---

[API](https://skmtc.dev/suki/apis/suki-developer-platform.md) · [All operations](https://skmtc.dev/suki/apis/suki-developer-platform/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/suki/suki-developer-platform/revisions/5f420a18fb68/schema)