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>"
}
'

import requests

url = "https://spaces.nexudus.com/api/public/visitors"

payload = {
    "[].BusinessId": 123,
    "[].FullName": "<string>",
    "[].ExpectedArrival": "<string>"
}
headers = {
    "Authorization": "Basic <encoded-value>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    '[].BusinessId': 123,
    '[].FullName': '<string>',
    '[].ExpectedArrival': '<string>'
  })
};

fetch('https://spaces.nexudus.com/api/public/visitors', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

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)