> This page is for version v1 (default).
> For other versions, use one of these documentation indexes:
> - v1 (default): https://developers.truemed.com/v-1/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developers.truemed.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.truemed.com/_mcp/server.

# Qualification Session Complete Webhook

POST 

The partner is required to implement an endpoint that Truemed requests to inform the partner
of the `qualification_session` status.

The `qualification_session_complete` webhook will only be called once for each qualification
session, on status change to `approved`, or `rejected`.

**Authentication**: Partners should verify the request comes from Truemed by checking that
the API key is present in the `x-truemed-api-key` HTTP header.

## Request Notes

- `status` - the status of the qualification session, an enum with one of the following
  values:
  - `pending` - the user hasn't has not completed the survey
  - `processing` - the user has completed the session and it is under review
  - `approved` - the user has been issued a Letter-of-Medical-Necessity
  - `rejected` - the user is ineligible to receive a Letter-of-Medical-Necessity
- `expires_at`: **(Optional)** - the datetime at which the Letter-of-Medical-Necessity expires
  - If the Letter-of-Medical-Necessity hasn't been issued, this field will be `null`.
- `user_id`: **(Optional)** - the `user_id` provided in the qualification session redirect
  URL param
  - This field will be `null` if `user_id` wasn't provided in the URL for creation.
- `source`: **(Optional)** - the `source` provided in the qualification session redirect URL
  param
  - This field will be `null` if `source` wasn't provided in the URL for creation.

## Response Notes

### Success Case

HTTP Status: `204`

The partner does not need to include any content in the body.

### Failure Case

Truemed will retry the requests to your backend with backoff for up to 7 days

Reference: https://developers.truemed.com/api-reference/qualification-sessions/qualification-status-updated-webhook

## Request

### Payload

- `qualification_session_id` (string, required) — The `qualification_session_id` returned by Truemed when the qualification session was created via `create_qualification_session`.
- `status` (string, required) — The status of the qualification_session.
- `email` (string, optional, nullable) — The email address of the consumer who completed the qualification session.
- `expires_at` (string, optional, nullable) — An optional datetime at which the Letter-of-Medical-Necessity expires (inclusive, UTC).
- `source` (string, optional, nullable) — An optional source, if provided in the redirect.
- `user_id` (string, optional, nullable) — An optional user_id, if provided in the redirect.