---
title: "Create form-filling session"
method: POST
path: "/api/v1/form-filling/session/create"
tags: ["/api/v1/form-filling/session"]
---

# Create form-filling session

`POST /api/v1/form-filling/session/create`

Creates a form-filling session for structured medical form capture. Returns a session ID in the `ambient_session_id` response field. That ID identifies the form-filling session for context, streaming, status, structured-data, and feedback APIs. It is not an ambient clinical documentation session ID.

## Headers

- `sdp_provider_id` string

## Request body

- ControllersCreateFormFillingSessionRequest — Optional form-filling session ID and correlation metadata. Suki generates a form-filling session ID when omitted.
  - `ambient_session_id` string — **Optional** - Form-filling session ID in UUID format. Suki generates one when omitted and returns it in the `ambient_session_id` response field. Do not pass an ambient clinical documentation session ID.
  - `correlation_id` string — **Optional** - Client-supplied identifier for tracing or correlating requests.

## Response `201`

Resource created successfully.

- ControllersCreateFormFillingSessionResponse — New form-filling session ID returned after create.
  - `ambient_session_id` string — Form-filling session ID for subsequent form-filling API calls. Despite the field name, this is not an ambient clinical documentation session ID.

## 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)