---
title: "Receive asynchronous notifications (partner webhook)"
method: POST
path: "/webhooks/notification"
tags: ["/webhooks"]
---

# Receive asynchronous notifications (partner webhook)

`POST /webhooks/notification`

Specification for the webhook endpoint your application hosts to receive asynchronous notifications from Suki when ambient session processing completes or fails. Suki sends POST requests to your configured notification URL.

## Request body

- ControllersFailureNotification — Webhook payload Suki sends when session processing fails.
  - `encounter_id` string — Id of the encounter to which the payload belongs.
  - `error_code` string — Error code.
  - `error_detail` string — Details of the error, if any.
  - `session_id` string — Id of the session that failed.
  - `status` string

## Response `200`

OK

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