Authentication
This endpoint requires OAuth2 authentication. Include a valid bearer token in the Authorization header.
The authenticated user must be a full unrestricted administrator or have the Visitor-Create role.
Enums
eVisitorSource — VisitorSource values
Value Name 1 Administrator 2 NexIO 3 Customer
eVisitorHostApprovalStatus — HostApprovalStatus values
Value Name 1 NotRequired 2 Requested 3 Rejected 4 AcceptedAndHold 5 AcceptedAndGrant
Request Body
Required Fields
Expected arrival date and time.
Optional Fields
Visitor source. Defaults to eVisitorSource.Administrator. See eVisitorSource enum above.
Host approval status. Defaults to eVisitorHostApprovalStatus.NotRequired. See eVisitorHostApprovalStatus enum above.
Whether the visitor has arrived.
Whether this is a tour visit.
Whether the visitor has agreed to terms.
Whether the tour is confirmed.
AccessControlScheduledJobId
Access Control Scheduled Job Id.
Check in the visitor now.
Code Examples
curl -X POST \
"https://spaces.nexudus.com/api/spaces/visitors" \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"BusinessId": 0,
"FullName": "",
"Email": "",
"ExpectedArrival": null
}'
Response
200
HTTP status code. 200 on success.
A human-readable message confirming the creation.
Contains the Id of the newly created record.
true if the visitor was created successfully.
{
"Status" : 200 ,
"Message" : "Visitor was successfully created." ,
"Value" : {
"Id" : 87654321
},
"OpenInDialog" : false ,
"OpenInWindow" : false ,
"RedirectURL" : null ,
"JavaScript" : null ,
"UpdatedOn" : "2025-01-15T10:30:00Z" ,
"UpdatedBy" : "admin@example.com" ,
"Errors" : null ,
"WasSuccessful" : true
}
400
A summary of the validation error(s), in the format PropertyName: error message.
null on validation failure.
Array of validation errors. The value that was submitted for the field, or null if missing.
The validation error message.
The name of the property that failed validation.
false when the request fails validation.
{
"Message" : "FullName: is a required field" ,
"Value" : null ,
"Errors" : [
{
"AttemptedValue" : null ,
"Message" : "is a required field" ,
"PropertyName" : "FullName"
}
],
"WasSuccessful" : false
}