Creating a host

POST /visitees

Adds a managed host to a location.

Body

string

required

The location.

string

required

Full name. Keep it identical to the recipient your other integrations send — that string is what links a visit to this host.

string

Email address for sign-in notifications. Stored lower-cased.

string

Mobile number for SMS notifications.

string

Desk phone, shown to reception.

boolean

Pin to the top of the kiosk list.

Response

string

Visitee added!

object

The host that was created.

curl -X POST https://api.vizito.eu/api/visitees \
  -H "Authorization: Bearer $VIZITO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "company_id": "5f2a1b9c4d3e2f0011223344",
    "cn": "Jane Doe",
    "mail": "jane.doe@example.com",
    "mobile": "+32470111222"
  }'

{
  "message": "Visitee added!",
  "data": {
    "_id": "66c1a2b3c4d5e6f700112299",
    "cn": "Jane Doe",
    "mail": "jane.doe@example.com"
  }
}

There is no duplicate check on cn. If your directory is the source of truth, replace the whole list instead of creating hosts one by one.

Getting started

Locations

Visitors

Registered visitors

Hosts

Visit types

Entry points

Agreements

Devices

Reporting

Webhooks

Creating a host

Body

Response

​Body

​Response

Body

Response