# Send notifications to video call participants

Canonical page: https://docs.ovok.com/api/video-call/send-notifications-to-video-call-participants

`POST /video-call/livekit/notification/active-call/{appointmentId}`

Tells the participants of a video call Appointment that the call is active, and lets them join on their own. A Practitioner calls it when they start the call.

**Auth:** bearer token. The caller must be a Practitioner, an admin or a super admin, or hold the "System Owner" access policy.
**Scope:** the caller's project (from the token).

## Behaviour

- Creates the access permission for the Appointment: a `CommunicationRequest` with the caller as sender and every Appointment participant as recipient. If one already exists for the Appointment, it is replaced.
- Patients need this permission to get a join link from `POST /video-call/livekit/user-access/{appointmentId}`.
- Queues a real-time event, `/video-call/livekit/notification/active-call`, for each participant who is not already in the LiveKit room. The event carries the sender's name, the Appointment id, description, start and end. Connect to the Ovok events socket to receive it.
- The route returns once the event is queued, not when it is delivered. The response is an `OperationOutcome` with severity `information`.

## Example

```bash
curl -X POST 'https://api.sandbox.ovok.com/video-call/livekit/notification/active-call/c3499c27-2973-0a7f-807e-fb8676a92dcb' \
  -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpYXQiOjE3NjcyNjg4MDAsImV4cCI6MTc2NzI3MjQwMH0.Ql3B_ztDvctlyZ2z0vp4sl3ExXRQGkzmxdmTAqxNzZk'
```