Join Event Waiting List

Adds the authenticated customer to the waiting list for a sold-out event.

POST /api/public/events/{id}/joinWaitingList

Join Event Waiting List

cURL

curl --request POST \
  --url https://spaces.nexudus.com/api/public/events/{id}/joinWaitingList \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "FullName": "<string>",
  "Email": "<string>"
}
'

import requests

url = "https://spaces.nexudus.com/api/public/events/{id}/joinWaitingList"

payload = {
    "FullName": "<string>",
    "Email": "<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({FullName: '<string>', Email: '<string>'})
};

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

200

{
  "401 Unauthorized": {},
  "404 Not Found": {},
  "400 Bad Request": {}
}

Join Event Waiting List

Registers the authenticated customer on the waiting list for an event that has no available tickets. When a spot becomes available, the operator can notify waiting-list members. Only callable when CalendarEvent.EnableWaitList is true and the event is sold out.

Authentication

Requires a valid customer bearer token.

Path Parameters

id · number · required

The integer ID of the event. Obtained as Id from GET /api/public/events or GET /api/public/events/{id}.

Request Body

The request body accepts the customer’s waiting-list registration data. The exact fields depend on the event configuration; pass an empty object {} if no additional fields are required.

FullName · string

Full name of the customer registering for the waiting list.

Email · string

Email address to notify when a spot becomes available.

Response

Returns an empty 200 OK on success.

Examples

Join the waiting list

POST /api/public/events/412/joinWaitingList
Authorization: Bearer {token}
Content-Type: application/json

{
  "FullName": "Alex Johnson",
  "Email": "[e-mail]"
}

HTTP/1.1 200 OK

TypeScript Integration

import endpoints from '@/api/endpoints'

await httpClient.post(endpoints.events.joinWaitingList(412), {
  FullName: 'Alex Johnson',
  Email: '[e-mail]',
})

Usage in Portal

Context	Source file
Event detail page — waiting list form (/events/{id})	src/views/events/details/data.ts
Waiting list form component	src/views/events/details/components/EventWaitingListForm.tsx

Error Responses

401 Unauthorized · error

The customer is not authenticated or the session has expired.

404 Not Found · error

No event with the specified ID exists.

400 Bad Request · error

The event does not have waiting list enabled (EnableWaitList is false), or the customer is already on the waiting list.

Related Endpoints

Method	Endpoint	Description
GET	/api/public/events/{id}	Full event detail including EnableWaitList flag
GET	/api/public/events	Paginated list of published events
GET	/api/public/events/my	Tickets held by the authenticated customer
GET	/api/public/events/{eventId}/product/{productId}	Ticket product availability detail