Create TimePass

POST

api

billing

timepasses

Create TimePass

curl --request POST \
  --url https://spaces.nexudus.com/api/billing/timepasses \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "BusinessId": 123,
  "Name": "<string>",
  "Price": 123,
  "CurrencyId": 123
}
'

import requests

url = "https://spaces.nexudus.com/api/billing/timepasses"

payload = {
    "BusinessId": 123,
    "Name": "<string>",
    "Price": 123,
    "CurrencyId": 123
}
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({BusinessId: 123, Name: '<string>', Price: 123, CurrencyId: 123})
};

fetch('https://spaces.nexudus.com/api/billing/timepasses', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

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

A Pass (internally TimePass) is a prepaid check-in allowance for a location, configured as either a day pass or a time-limited pass with availability, customer, pricing, and access-control rules.

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

Request Body

Required Fields

integer

required

ID of the location that owns this pass and supplies its default location scope and local check-in schedule..

string

required

Required pass name, up to 254 characters; this is the customer-facing name used to identify the pass..

number

required

Base amount charged in the selected currency; the lowest matching plan-specific special price overrides this amount for eligible members..

integer

required

ID of the ISO 4217 currency used for the pass price and plan-specific special prices..

Optional Fields

string

Optional custom text shown on invoice lines instead of the pass name..

integer

Non-negative total check-in allowance in minutes; leave null for a day pass that can be used repeatedly during one calendar day..

boolean

Whether check-ins made with this pass count against the customer’s plan check-in and time limits..

boolean

Whether this pass can be automatically sold to members who check in without a valid pass when pay-as-you-go check-in is enabled..

boolean

Whether this pass can be automatically sold to contacts without an active contract who check in without a valid pass when pay-as-you-go check-in is enabled..

integer

Optional pass-selection priority when a customer has multiple valid passes; higher values are used first and null is treated as normal priority (0)..

integer

Optional ID of the standard tax rate applied when this pass is invoiced..

integer

Optional ID of the reduced tax rate applied when the customer qualifies for reduced taxation..

integer

Optional ID of the tax rate applied when the customer is tax exempt..

integer

Optional ID of the financial account used to record pass revenue..

integer[]

List of locations where this pass can be used; when empty, it is valid at the owning location and its child locations, while a non-empty list restricts use to those locations..

string

Optional external Kisi access-control group ID assigned to customers using this pass..

string

Optional external DoorGuard access-control group ID assigned to customers using this pass..

string

Legacy single access-control group ID; do not use this field because provider-specific access groups are managed through the current access-control integration..

boolean

Whether a customer holding this pass can check in to the location’s connected IT network..

boolean

Whether this pass is restricted to contacts without an active contract; do not combine with OnlyForMembers..

boolean

Whether this pass is restricted to members with an active contract; when Tariffs is non-empty, the member must have an active contract on one of those plans, and this must not be combined with OnlyForContacts..

integer[]

List of plans whose active members can use this pass when OnlyForMembers is true; an empty list allows members on any plan..

boolean

Whether this pass is archived and should no longer appear in active pass lists..

Code Examples

curl -X POST \
  "https://spaces.nexudus.com/api/billing/timepasses" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "BusinessId": 0,
    "Name": "",
    "Price": 0,
    "CurrencyId": 0
}'

const response = await fetch(
  'https://spaces.nexudus.com/api/billing/timepasses',
  {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer YOUR_TOKEN',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      BusinessId: 0,
      Name: '',
      Price: 0,
      CurrencyId: 0
    })
  }
);

const data = await response.json();

import requests

response = requests.post(
    'https://spaces.nexudus.com/api/billing/timepasses',
    headers={
        'Authorization': 'Bearer YOUR_TOKEN',
        'Content-Type': 'application/json'
    },
    json={
        'BusinessId': 0,
        'Name': '',
        'Price': 0,
        'CurrencyId': 0
    }
)

data = response.json()

Response

200

integer

HTTP status code. 200 on success.

string

A human-readable message confirming the creation.

object

Contains the Id of the newly created record.

boolean

true if the timepass was created successfully.

array

null on success.

Example Response

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

string

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

any

null on validation failure.

object[]

Array of validation errors.

Show child attributes

any

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

string

The validation error message.

string

The name of the property that failed validation.

boolean

false when the request fails validation.

Example Response

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

Create TimePass

curl --request POST \
  --url https://spaces.nexudus.com/api/billing/timepasses \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "BusinessId": 123,
  "Name": "<string>",
  "Price": 123,
  "CurrencyId": 123
}
'

import requests

url = "https://spaces.nexudus.com/api/billing/timepasses"

payload = {
    "BusinessId": 123,
    "Name": "<string>",
    "Price": 123,
    "CurrencyId": 123
}
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({BusinessId: 123, Name: '<string>', Price: 123, CurrencyId: 123})
};

fetch('https://spaces.nexudus.com/api/billing/timepasses', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

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

Overview

Apps & Marketplace

Billing

Collaboration

Community

Content

CRM

Security

Spaces

Support

System

Authentication

Request Body

Required Fields

Optional Fields

Code Examples

Response

200

400

​Authentication

​Request Body

​Required Fields

​Optional Fields

​Code Examples

​Response

​200

​400

Authentication

Request Body

Required Fields

Optional Fields

Code Examples

Response

200

400