Creating a registered visitor

POST /knownvisitors

Creates a registered visitor: somebody you expect. When they arrive and sign in, a visit is created from this record and the record itself stays as it is.

Body

string

required

The location they are expected at.

string

Visit type they will go through on arrival.

string

First name.

string

Last name.

string

The organisation they come from.

string

Email address. Required if you want to invite them — records without one are skipped by the invitation endpoints.

string

Phone number, international format.

string

Name of the host. Matching an existing host’s cn fills in that host’s email and mobile on the invitation.

object

When the visit is expected: { "startDate": "...", "endDate": "..." }, both ISO 8601. Leave it out for somebody with no fixed date — they are then offered on the kiosk every day.

boolean

default:"false"

Keep the record after the visit. Persistent records are never removed by data retention — use it for contractors and regulars.

string

Language of the invitation email, e.g. nl.

string

Any field the visit type defines, under its field_name. Carried onto the visit on arrival — including fields hidden on the kiosk.

Response

string

Known Visitor added!

object

The record that was created. Keep data._id: the invitation, the QR code and the sign-in all key on it.

curl -X POST https://api.vizito.eu/api/knownvisitors \
  -H "Authorization: Bearer $VIZITO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "company_id": "5f2a1b9c4d3e2f0011223344",
    "visit_type": "5f2a1b9c4d3e2f0011223399",
    "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"
    }
  }'

{
  "message": "Known Visitor added!",
  "data": {
    "_id": "66c1a2b3c4d5e6f700112233",
    "first_name": "Ada",
    "visiting_on": {
      "startDate": "2026-09-03T08:00:00.000Z",
      "endDate": "2026-09-03T17:00:00.000Z"
    },
    "create_date": "2026-08-29T09:14:02.000Z"
  }
}

Creating the record does not mail anybody. Send the invitation as a separate step — see Sending an invitation.

Getting started

Locations

Visitors

Registered visitors

Hosts

Visit types

Entry points

Agreements

Devices

Reporting

Webhooks

Creating a registered visitor

Body

Response

​Body

​Response

Body

Response