Create Resource

Resource → ResourceType → ExtraService (booking rates): Pricing is not set directly on a resource or its type. Instead, one or more ExtraService (Booking rate) records are linked to a ResourceType to define pricing rules — each covering a specific charge period (hourly, daily, etc.) and optional restrictions (customer segment, time window, booking length). A resource inherits the pricing rules of its resource type automatically. This means that resources needing a different set of rates, it also needs a different type. You must know the ResourceTypeId before creating a resource.

​

Booking policies and restrictions

• Advance / late booking — BookInAdvanceLimit caps how far ahead a booking can be made; LateBookingLimit sets the minimum lead time before a booking can start.
• Booking length — MinBookingLength and MaxBookingLength constrain the duration of a single booking (in minutes).
• Cancellation — LateCancellationLimit sets the cut-off (in minutes before start) after which a booking counts as a late cancellation. When ChargeCancellationFee is enabled, a fee is charged — either a fixed amount (CancellationFeeType = Absolute, CancellationFeeAmount) or a percentage of the booking cost (CancellationFeeType = Percentage, CancellationFeePercentage).
• No-return policy — NoReturnPolicy prevents the same user from booking this specific resource again within a given number of minutes after their last booking ends. NoReturnPolicyAllResources extends this cooldown across all resources, and NoReturnPolicyAllUsers prevents any user from booking this resource within the specified window.
• Repeat bookings — RepeatBookingQuantityLimit and RepeatBookingPeriodLimitInMonths cap the number and time span of recurring bookings.
• Capacity — Allocation sets the maximum number of attendees. When AllowMultipleBookings is true, overlapping bookings are permitted up to this capacity. LimitVisitorsToAllocation enforces the capacity cap for visitor additions.
• Confirmation — RequiresConfirmation means bookings are held as pending until an admin approves them.
• Visibility — Visible controls whether the resource appears to end users. Archived hides the resource from all views.

​

Access restrictions

• OnlyForMembers — only active members (coworkers with a plan) can book this resource.
• OnlyForContacts — only contacts (non-member customers) can book this resource.
• Tariffs — restrict bookings to coworkers on specific pricing plans.
• Teams — restrict bookings to members of specific teams.

​

Amenity flags

​

Authentication

​

Enums

​

Request Body

​

Required Fields

​

Optional Fields

​

Children

​

Code Examples

curl -X POST \
  "https://spaces.nexudus.com/api/spaces/resources" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "BusinessId": 0,
    "Name": "",
    "SystemResourceType": 0,
    "ResourceTypeId": 0,
    "DisplayOrder": 0,
    "CancellationFeeType": 0,
    "TimeSlots": [
        {
            "DayOfWeek": 0,
            "FromTime": "2025-01-15T10:30:00Z",
            "ToTime": "2025-01-15T10:30:00Z"
        }
    ]
}'

const response = await fetch(
  'https://spaces.nexudus.com/api/spaces/resources',
  {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer YOUR_TOKEN',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      BusinessId: 0,
      Name: '',
      SystemResourceType: 0,
      ResourceTypeId: 0,
      DisplayOrder: 0,
      CancellationFeeType: 0,
      TimeSlots: [object Object]
    })
  }
);

const data = await response.json();

import requests

response = requests.post(
    'https://spaces.nexudus.com/api/spaces/resources',
    headers={
        'Authorization': 'Bearer YOUR_TOKEN',
        'Content-Type': 'application/json'
    },
    json={
        'BusinessId': 0,
        'Name': '',
        'SystemResourceType': 0,
        'ResourceTypeId': 0,
        'DisplayOrder': 0,
        'CancellationFeeType': 0,
        'TimeSlots': [object Object]
    }
)

data = response.json()

​

Response

​

200

{
  "Status": 200,
  "Message": "Resource 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": "Name: is a required field",
  "Value": null,
  "Errors": [
    {
      "AttemptedValue": null,
      "Message": "is a required field",
      "PropertyName": "Name"
    }
  ],
  "WasSuccessful": false
}