---
title: "Partner launch session event"
method: POST
path: "partnerLaunchSessionEvent"
tags: ["partner-webhooks"]
---

# Partner launch session event

`POST partnerLaunchSessionEvent` (webhook)

Signed notification sent to the HTTPS webhook URL registered during onboarding. Verify the HMAC-SHA256 signature against the exact raw request body using the dedicated webhook secret. Return any 2xx response within 10 seconds after durable acceptance.

## Headers

- `Everbility-Webhook-Id` string, required
- `Everbility-Webhook-Timestamp` string, required
- `Everbility-Webhook-Signature` string, required

## Payload

- PartnerWebhookEvent — Signed launch-session lifecycle event. The event ID and serialized payload remain stable across retries; the delivery timestamp and signature change for each attempt.
  - `id` string, required — Stable event ID used for deduplication.
  - `type` 'launch_session.opened' | 'launch_session.completed' | 'launch_session.expired', required
  - `created_at` string, date-time, required
  - `data` object, required
    - `session_id` string, required
    - `status` 'opened' | 'completed' | 'expired', required
    - `external_client_id` string, required
    - `clinician_email` string, required — Assigned clinician's normalized email address.
    - `opened_at` string, date-time, nullable, required
    - `completed_at` string, date-time, nullable, required
    - `expires_at` string, date-time, required
    - `document_url` string, nullable, required — API-relative document URL, populated only for launch_session.completed.

## Acknowledgement `200`

Event accepted. Any 2xx status is treated as success.

## Other responses

- `default` — A non-2xx response causes a retry. Redirects are not followed.

---

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