Create Booking - Nexudus Platform

POST

api

spaces

bookings

Create Booking

curl --request POST \
  --url https://spaces.nexudus.com/api/spaces/bookings \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "ResourceId": 123,
  "FromTime": "<string>",
  "ToTime": "<string>",
  "Repeats": 123,
  "WhichBookingsToUpdate": 123
}
'

{
  "Status": 123,
  "Message": "<string>",
  "Value": "<any>",
  "WasSuccessful": true,
  "Errors": [
    {
      "AttemptedValue": "<any>",
      "Message": "<string>",
      "PropertyName": "<string>"
    }
  ]
}

A Booking is a reservation for a specific Resource and, optionally, for a customer (CoworkerId) and a desk or unit in the floor plan (FloorPlanDeskId). Charging vs Invoicing — When a booking is charged (confusingly labelled Invoiced in the booking entity), a charge is posted to the customer account as a CoworkerExtraService with the calculated price. If the booking has no fixed rate (ExtraServiceId = null), Nexudus calculates the rate automatically based on the resource type, booking parameters and customer. A booking is actually invoiced when the CoworkerExtraService associated with it is invoiced.

InvoiceThisCoworker = true means the booking is charged to the customer making it rather than their paying member (if any).
Tentative bookings must be approved by an administrator before being confirmed or charged. They still block the calendar.
Online bookings are those made via the portal or the app.

Repeating bookings — RepeatBooking and all repeat-configuration fields (Repeats, RepeatEvery, RepeatUntil, RepeatOn*) are create-only. Once a booking series is created, only WhichBookingsToUpdate can be used to update or delete bookings in the series. No new bookings can be added to an existing series. Pricing overrides — OverridePrice lets an admin set a fixed price for the booking, regardless of what extra service (rate) is associated with it.

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 Booking-Create role.

Enums

eBookingRepeatCycle — Repeats values

Value	Name
1	Daily
2	Weekly
3	Monthly
4	Yearly
5	FirstOfMonth
6	SecondOfMonth
7	ThirdOfMonth
8	LastOfMonth
9	FourthOfMonth

eRepeatedBookingUpdateAction — WhichBookingsToUpdate values

Value	Name
1	UpdateThisBookingOnly
2	UpdateFutureBookingsOnly
3	UpdateAllBookings
4	UpdateNotChargedBookings
5	DeleteAllBookings
6	DeleteBookingsAfterThis
7	DeleteNotChargedBookings
8	RevertAllCharges

Request Body

Required Fields

ResourceId

integer

required

ID of the resource linked to this record.

FromTime

string

required

Booking start time.

ToTime

string

required

Booking end time.

Repeats

integer

required

Repeat cycle. Create-only. Defaults to eBookingRepeatCycle.Weekly.

WhichBookingsToUpdate

integer

required

Action to apply when updating or deleting bookings in a repeated series. This is the only field that can modify a series after creation. Defaults to eRepeatedBookingUpdateAction.UpdateThisBookingOnly.

Optional Fields

FloorPlanDeskId

integer

ID of the floor plan desk linked to this record.

CoworkerId

integer

ID of the coworker linked to this record.

ExtraServiceId

integer

ID of the extra service linked to this record.

Notes

string

Optional notes or comments about this booking.

InternalNotes

string

Internal notes.

ChargeNow

boolean

Charge immediately.

InvoiceNow

boolean

Invoice immediately.

InvoiceThisCoworker

boolean

Charge the booking to the customer making it rather than their paying member (if any).

DoNotUseBookingCredit

boolean

Do not use booking credit.

PurchaseOrder

string

Purchase order.

DiscountCode

string

Discount code.

LastNotificationTime

string

Date/time value for last notification time.

GoogleCalendarId

string

ID of the google calendar associated with this record.

GoogleEventId

string

ID of the google event associated with this record.

Office365EventId

string

ID of the office365 event associated with this record.

PublicGoogleEventId

string

ID of the public google event associated with this record.

Tentative

boolean

Tentative booking. Must be approved by an administrator before confirmed or charged. Tentative bookings still block the calendar.

TeamsAtTheTimeOfBooking

string

Teams at the time of booking.

TariffAtTheTimeOfBooking

string

Tariff at the time of booking.

RepeatSeriesUniqueId

string

ID of the repeat series unique associated with this record.

RepeatBooking

boolean

Create a repeating booking series. Create-only: once created, only WhichBookingsToUpdate can be used to update the series. No new bookings can be added to the series.

RepeatEvery

integer

Repeat every N periods. Create-only.

RepeatUntil

string

Repeat until date. Create-only.

RepeatOnMondays

boolean

Repeat on Mondays. Create-only.

RepeatOnTuesdays

boolean

Repeat on Tuesdays. Create-only.

RepeatOnWednesdays

boolean

Repeat on Wednesdays. Create-only.

RepeatOnThursdays

boolean

Repeat on Thursdays. Create-only.

RepeatOnFridays

boolean

Repeat on Fridays. Create-only.

RepeatOnSaturdays

boolean

Repeat on Saturdays. Create-only.

RepeatOnSundays

boolean

Repeat on Sundays. Create-only.

Reminded

boolean

Whether reminded is enabled.

MrmReminded

boolean

Whether mrm reminded is enabled.

OverridePrice

number

Admin-set fixed price for the booking, regardless of what extra service (rate) is associated with it.

KisiKeyId

integer

ID of the kisi key associated with this record.

StartScheduledJobId

string

ID of the start scheduled job associated with this record.

EndScheduledJobId

string

ID of the end scheduled job associated with this record.

Billed

boolean

Whether billed is enabled.

FromTimeLocal

string

Date/time value for from time local.

ToTimeLocal

string

Date/time value for to time local.

InvoiceDateLocal

string

Date/time value for invoice date local.

CoworkerExtraServicePrice

number

The coworker extra service price value for this booking.

IncludeZoomInvite

boolean

Include Zoom invite.

ZoomEventData

string

The zoom event data value for this booking.

Office365AdminEventId

string

ID of the office365 admin event associated with this record.

Children

BookingProducts

object[]

Products to include with this booking

Show child attributes

ProductId

integer

required

ID of the product linked to this record.

Quantity

integer

required

The number of units of this product to include in the booking.

InvoiceInMinutes

boolean

Whether to invoice this product based on the booking duration in minutes.

BookingVisitors

object[]

Visitors to add to this booking

Show child attributes

VisitorFullName

string

Full name of the visitor. Read-only, resolved from the linked Visitor record..

VisitorEmail

string

Email address of the visitor. Read-only, resolved from the linked Visitor record..

Code Examples

curl -X POST \
  "https://spaces.nexudus.com/api/spaces/bookings" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "ResourceId": 0,
    "FromTime": "2025-01-15T10:30:00Z",
    "ToTime": "2025-01-15T10:30:00Z",
    "Repeats": 0,
    "WhichBookingsToUpdate": 0,
    "BookingProducts": [
        {
            "ProductId": 0,
            "Quantity": 0,
            "InvoiceInMinutes": false
        }
    ],
    "BookingVisitors": [
        {
            "VisitorFullName": null,
            "VisitorEmail": null
        }
    ]
}'

Response

200

Status

integer

HTTP status code. 200 on success.

Message

string

A human-readable message confirming the creation.

Value

object

Contains the Id of the newly created record.

WasSuccessful

boolean

true if the booking was created successfully.

Errors

array

null on success.

Example Response

{
  "Status": 200,
  "Message": "Booking 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

Message

string

A summary of the validation error(s), in the format PropertyName: error message.

Value

any

null on validation failure.

Errors

object[]

Array of validation errors.

Show child attributes

AttemptedValue

any

The value that was submitted for the field, or null if missing.

Message

string

The validation error message.

PropertyName

string

The name of the property that failed validation.

WasSuccessful

boolean

false when the request fails validation.

Example Response

{
  "Message": "FromTime: is a required field",
  "Value": null,
  "Errors": [
    {
      "AttemptedValue": null,
      "Message": "is a required field",
      "PropertyName": "FromTime"
    }
  ],
  "WasSuccessful": false
}

Update BookingUpdate an existing Booking record.

Create Booking

curl --request POST \
  --url https://spaces.nexudus.com/api/spaces/bookings \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "ResourceId": 123,
  "FromTime": "<string>",
  "ToTime": "<string>",
  "Repeats": 123,
  "WhichBookingsToUpdate": 123
}
'

{
  "Status": 123,
  "Message": "<string>",
  "Value": "<any>",
  "WasSuccessful": true,
  "Errors": [
    {
      "AttemptedValue": "<any>",
      "Message": "<string>",
      "PropertyName": "<string>"
    }
  ]
}

​Authentication

​Enums

​Request Body

​Required Fields

​Optional Fields

​Children

​Code Examples

​Response

​200

​400

Authentication

Enums

Request Body

Required Fields

Optional Fields

Children

Code Examples

Response

200

400