---
title: "Create Launch Session"
method: POST
path: "/v1/partner/launch-sessions"
tags: ["partner"]
---

# Create Launch Session

`POST /v1/partner/launch-sessions`

Create a report-writing launch session for a clinician in the connected practice. Requires an Idempotency-Key header: retrying with the same key and identical body returns the original session; reusing a key with a different body fails with 409. Sessions expire 48 hours after creation if not completed. Open the returned launch_url for the clinician.

## Headers

- `Idempotency-Key` string, required

## Request body

- PartnerLaunchSessionCreateInput
  - `external_client_id` string, required — Your platform's ID for the client. Used to remember the client mapping across sessions on this connection.
  - `clinician_email` string, required — Must match the verified email of exactly one member of the connected practice. Matching is case-insensitive.
  - `client_first_name` string, nullable — Shown to the clinician when mapping the client for the first time.
  - `client_last_name` string, nullable — Shown to the clinician when mapping the client for the first time.

## Response `200`

Session created (or the existing session for a repeated Idempotency-Key).

- PartnerLaunchSessionCreateResponse
  - `session_id` string, required
  - `status` 'created' | 'opened' | 'completed' | 'expired', required
  - `launch_url` string, required — Open this URL for the assigned clinician to write the report in Everbility.
  - `expires_at` string, date-time, required — Sessions expire 48 hours after creation if not completed.

## Other responses

- `400` — Missing Idempotency-Key, or clinician_email did not match exactly one verified practice member.
- `401` — Invalid or expired access token, or the connection was revoked.
- `403` — The mapped Everbility client is not accessible to the assigned clinician.
- `409` — Idempotency-Key was reused with a different request body.
- `422` — Validation Error

## Changes

- **2026-07-06** `667e3a14dd18` — 1 info
  - endpoint added
- **2026-03-16** `9695d93a926b` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/everbility/apis/everbility-public-api/changes/v1/partner/launch-sessions/post.md)

---

[API](https://skmtc.dev/everbility/apis/everbility-public-api.md) · [All operations](https://skmtc.dev/everbility/apis/everbility-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/everbility/everbility-public-api/revisions/0d4efb7914d1/schema)