> ## Documentation Index
> Fetch the complete documentation index at: https://learn.nexudus.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Register Visitor

> Registers a new visitor for the authenticated customer.

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

<ParamField body="[].BusinessId" type="number" required>
  Numeric identifier of the location where the visitor is expected.
</ParamField>

<ParamField body="[].FullName" type="string" required>
  Full name of the visitor.
</ParamField>

<ParamField body="[].Email" type="string">
  Email address of the visitor (for notifications).
</ParamField>

<ParamField body="[].PhoneNumber" type="string">
  Phone number of the visitor.
</ParamField>

<ParamField body="[].ExpectedArrival" type="string" required>
  Expected arrival date/time in ISO 8601 format.
</ParamField>

<ParamField body="[].CustomerNotes" type="string">
  Notes from the host for the visitor or front desk.
</ParamField>

## Response

Returns a `200 OK` on success.

## Examples

### Register a visitor

```http theme={null}
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

```typescript theme={null}
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)
```