# Send emails: video call invitation

Canonical page: https://docs.ovok.com/api/video-call/send-emails-video-call-invitation

`POST /video-call/livekit/mail/invite`

Sends invitation emails for a video call Appointment to the recipients you list. The route does not change the Appointment.

**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

- `emailRecipients` takes 1 to 20 entries. Each has an `email` and a `profileRef` (`Practitioner/<id>` or `Patient/<id>`). Duplicate emails are dropped.
- The caller is never emailed, even when listed. If no recipient is left, the route returns an empty `emailRecipientsResult`.
- The email contains the recipient's TAN (a one-time access code) and its expiry. A recipient with no TAN gets no email and `isEmailSent` is `false`.
- The email includes the Appointment title, the practitioner's name, start and end in CET. The `Origin` header of your request sets the app domain used in the email, and the request language sets its language.
- Emails are sent one by one. A failed send does not fail the request. Check `isEmailSent` for each recipient.

## Example

```bash
curl -X POST 'https://api.sandbox.ovok.com/video-call/livekit/mail/invite' \
  -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpYXQiOjE3NjcyNjg4MDAsImV4cCI6MTc2NzI3MjQwMH0.Ql3B_ztDvctlyZ2z0vp4sl3ExXRQGkzmxdmTAqxNzZk' \
  -H 'Content-Type: application/json' \
  -d '{
    "appointmentId": "c3499c27-2973-0a7f-807e-fb8676a92dcb",
    "emailRecipients": [{
      "email": "max.mustermann@example.com",
      "profileRef": "Patient/c3499c27-2973-0a7f-807e-fb8676a92dcb"
    }]
  }'
```