# Create video call guest access

Canonical page: https://docs.ovok.com/api/video-call/create-video-call-guest-access

`POST /video-call/livekit/guest-access/{appointmentId}`

Creates a join link for a video call Appointment for someone who has no Ovok account. A Practitioner calls it, then shares the returned `videoCallUrl` with the guest.

**Auth:** bearer token. The caller must be a Practitioner.
**Scope:** the caller's project (from the token). The Appointment is read in that project.

## Behaviour

- The guest has no room admin rights. The guest's display name in the call is `guestEmail`.
- The link is valid from 1 hour before the Appointment `start` until 1 hour after its `end`.
- The route does not send an email. To email the link, use the video call mail routes.
- Every call returns a new token. Earlier tokens stay valid until they expire.
- The response holds `videoCallUrl` (the full join link), `livekitJwt` and `passphrase`. The passphrase is the one stored on the Appointment and is also the fragment of `videoCallUrl`.

## Example

```bash
curl -X POST 'https://api.sandbox.ovok.com/video-call/livekit/guest-access/c3499c27-2973-0a7f-807e-fb8676a92dcb' \
  -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpYXQiOjE3NjcyNjg4MDAsImV4cCI6MTc2NzI3MjQwMH0.Ql3B_ztDvctlyZ2z0vp4sl3ExXRQGkzmxdmTAqxNzZk' \
  -H 'Content-Type: application/json' \
  -d '{ "guestEmail": "max.mustermann@example.com" }'
```