Sending an invitation

POST /knownvisitors/sendinvite/{language_id}

Sends the invitation email: the QR code that signs them in on arrival, the calendar item, the wallet pass and the pre-registration link — whichever the visit type is configured to include.

Path parameters

string

required

Language of the email: en, nl, fr, de, … Falls back to en.

Body

The registered visitor to invite — send the object you got back when you created it.

string

required

The registered visitor id. The QR code and the pre-registration link are derived from it.

string

required

The location.

string

required

Where the invitation goes.

string

The rest of the record — name, host, visiting_on — used to fill the placeholders in the mail.

Response

An empty 200 once the mail is queued.

cURL

curl -X POST https://api.vizito.eu/api/knownvisitors/sendinvite/en \
  -H "Authorization: Bearer $VIZITO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "_id": "66c1a2b3c4d5e6f700112233",
    "company_id": "5f2a1b9c4d3e2f0011223344",
    "first_name": "Ada",
    "last_name": "Lovelace",
    "email": "ada@example.com",
    "recipient": "Jane Doe",
    "visiting_on": {
      "startDate": "2026-09-03T08:00:00.000Z",
      "endDate": "2026-09-03T17:00:00.000Z"
    }
  }'

Create the registered visitor first. An invitation sent for an id that does not exist produces a mail whose QR code signs nobody in.

Locations on a trial are capped at 10 invitations; past that the endpoint answers 400 { "message": "too many invitations sent" }.

Getting started

Locations

Visitors

Registered visitors

Hosts

Visit types

Entry points

Agreements

Devices

Reporting

Webhooks

Sending an invitation

Path parameters

Body

Response

​Path parameters

​Body

​Response

Path parameters

Body

Response