> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nevatal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhooks

> Receive real-time notifications when events happen in your clinic

# Webhooks

<Note>
  Webhook support is coming soon. This page describes the planned architecture.
</Note>

Nevatal webhooks allow your application to receive real-time HTTP notifications when events occur in your clinic — such as new appointments, payments, or patient updates.

## How webhooks work

1. You register a webhook endpoint URL in your Nevatal dashboard
2. When an event occurs, Nevatal sends a `POST` request to your URL
3. Your server processes the event and responds with `200 OK`

## Planned events

| Event                   | Description                            |
| ----------------------- | -------------------------------------- |
| `appointment.created`   | A new appointment was scheduled        |
| `appointment.updated`   | An appointment was rescheduled         |
| `appointment.canceled`  | An appointment was canceled            |
| `appointment.completed` | An appointment was marked as completed |
| `patient.created`       | A new patient was registered           |
| `patient.updated`       | Patient information was updated        |
| `invoice.created`       | A new invoice was created              |
| `invoice.approved`      | An invoice was approved                |
| `payment.received`      | A payment was recorded                 |

## Webhook payload format

```json theme={null}
{
  "event": "appointment.created",
  "timestamp": "2025-04-01T09:00:00Z",
  "data": {
    "id": "apt_xyz789",
    "patientId": "pat_abc123",
    "doctorId": "usr_doctor456",
    "startTime": "2025-04-01T09:00:00-05:00"
  }
}
```

## Security

Webhook payloads include a signature in the `X-Nevatal-Signature` header for verification. Details on signature validation will be provided when webhooks launch.

## Interested?

Contact [soporte@nevatal.com](mailto:soporte@nevatal.com) to join the webhook beta program.