POST

api

public

visitors

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).

number

required

Numeric identifier of the location where the visitor is expected.

string

required

Full name of the visitor.

string

Email address of the visitor (for notifications).

string

Phone number of the visitor.

string

required

Expected arrival date/time in ISO 8601 format.

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": "sarah@example.com",
    "PhoneNumber": "+44 7700 900000",
    "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)

Delete VisitorRemoves a registered visitor.

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

​Authentication

​Request Body

​Response

​Examples

​Register a visitor

​TypeScript Integration

Register Visitor

Authentication

Request Body

Response

Examples

Register a visitor

TypeScript Integration