Register Visitor

Registers a new visitor for the authenticated customer.

POST /api/public/visitors

Register Visitor

cURL

curl --request POST \
  --url https://spaces.nexudus.com/api/public/visitors \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "[].BusinessId": 123,
  "[].FullName": "<string>",
  "[].ExpectedArrival": "<string>"
}
'

Register Visitor

Registers a new visitor expected at the coworking space. The visitor receives a notification and the front desk is alerted when they arrive.

Authentication

Requires a valid customer bearer token.

Request Body

The request body is an array of visitor objects. Multiple visitors can be registered in a single request (e.g. for recurring visits).

[].BusinessId · number · required

Numeric identifier of the location where the visitor is expected.

[].FullName · string · required

Full name of the visitor.

[].Email · string

Email address of the visitor (for notifications).

[].PhoneNumber · string

Phone number of the visitor.

[].ExpectedArrival · string · required

Expected arrival date/time in ISO 8601 format.

[].CustomerNotes · string

Notes from the host for the visitor or front desk.

Response

Returns a 200 OK on success.

Examples

Register a visitor

POST /api/public/visitors
Authorization: Bearer {token}
Content-Type: application/json

[
  {
    "BusinessId": 1,
    "FullName": "Sarah Connor",
    "Email": "[e-mail]",
    "PhoneNumber": "[phone]",
    "ExpectedArrival": "2026-04-01T10:00:00Z",
    "CustomerNotes": "Meeting in room 3"
  }
]

TypeScript Integration

import endpoints from '@/api/endpoints'

const visitors = repeatDates.map((date) => ({
  BusinessId: values.BusinessId,
  FullName: values.FullName,
  Email: values.Email,
  PhoneNumber: values.PhoneNumber,
  ExpectedArrival: date.toJSDate(),
  CustomerNotes: values.CustomerNotes,
}))

await httpClient.post(endpoints.visitors.create, visitors)