Create Launch Session
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.
Authorizations
Opaque partner access token (pat_...) issued by POST /v1/partner/oauth/token. Access tokens last 1 hour; refresh with the 90-day refresh token.
Headers
Unique key per logical session (for example a UUID). Enables safe retries.
Body
Your platform's ID for the client. Used to remember the client mapping across sessions on this connection.
1 - 255Must match the verified email of exactly one member of the connected practice. Matching is case-insensitive.
3 - 320Shown to the clinician when mapping the client for the first time.
255Shown to the clinician when mapping the client for the first time.
255Response
Session created (or the existing session for a repeated Idempotency-Key).
created, opened, completed, expired Open this URL for the assigned clinician to write the report in Everbility.
Sessions expire 48 hours after creation if not completed.