# Webhooks
Landing: https://developers.vsee.io/api/webhooks  ·  Spec JSON: https://developers.vsee.io/specs/webhooks_openapi.json
Base URL: https://api.vseepreview.com/api_v3

Webhook event documentation for VSee Clinic API

## POST /webhooks/events
URL: https://developers.vsee.io/api/webhooks/post/webhooks/events
operationId: webhookEvent
Auth: Admin Token — Requires the Clinic Admin API Token from your dashboard (Developers → App → Edit App).

Webhook event

Webhook events are sent to your configured webhook URL. This documents the available event types and their payloads.

Parameters:
- X-ApiToken (header, string, required) — API token
- X-AccountCode (header, string, required) — Account code

Request body (application/json):

Example request:
```json
{
  "version": "1.0",
  "id": "5c34979c-30dc-496c-8cd3-6eb9925862c1",
  "type": "visit.created",
  "created": 1546950556,
  "account_code": "xxx",
  "data": {
    "id": "28540",
    "member_id": "60610",
    "provider_id": null,
    "start": "1546950546",
    "end": "1546951446",
    "actual_start": "1546950546",
    "actual_end": "1546950555",
    "status": "scheduled",
    "completed_by": "60610"
  }
}
```

Responses:
- 200 — Webhook received successfully