Create AutomationTile

POST

api

sys

automationtiles

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

import requests

url = "https://spaces.nexudus.com/api/sys/automationtiles"

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

fetch('https://spaces.nexudus.com/api/sys/automationtiles', 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>"
    }
  ]
}

An AutomationTile represents a physical NFC chip and QR code tile that triggers actions in a Nexudus-powered coworking space. Each tile is linked to a single action (e.g. check-in, booking, door unlock, HTTP request) that fires when a customer scans or taps the tile. The Action field determines what happens when the tile is scanned. Some actions require additional data in ActionParameters:

Action	ActionParameters format
CheckIn / CheckOut / EventCheckIn	Not required
BookingCheckIn / ResourceCleaned / ShowNewBookingForm	Resource ID
BookResource	Resource ID `\|` default booking length in minutes (default 60)
BookDesk	Desk (floor plan item) ID `\|` default booking length in minutes (default 480)
ExtendBookingBy	Number of minutes to extend
RequestUrl	Target URL for the HTTP POST request
RedirectUrl	URL to redirect the user to
UnlockAct365Door / UnlockDoorDeckDoor / UnlockKisiDoor	Door ID from the access-control provider
SmartLock	Smartalock locker bank ID

Tiles can optionally be geo-fenced to restrict scanning to a physical area around the tile’s installed location. Enable EnableGeofence, set Latitude/Longitude, and choose a GeofencePrecission level. MaxDistanceMeters overrides the precision preset with a custom radius. Set CheckCustomerIn to also check the customer into the space when they scan the tile, regardless of the tile’s primary action.

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

Enums

eAutomationTileAction — Action values

Value	Name
1	None
2	UnlockAct365Door
3	CheckIn
4	CheckOut
5	BookingCheckIn
6	EventCheckIn
7	ResourceCleaned
8	RequestUrl
9	RedirectUrl
10	UnlockDoorDeckDoor
11	UnlockKisiDoor
12	BookResource
13	BookDesk
14	ShowNewBookingForm
15	SmartLock
16	ExtendBookingBy
17	ShowAcsModal
18	UnlockPadWordDoor
19	UnlockOPaxtonNet2Door

eAutomationTileGeofencePrecission — GeofencePrecission values

Value	Name
1	Low
2	Medium
3	High
4	VeryHigh

Request Body

Required Fields

integer

required

ID of the business linked to this record.

string

required

Tile name used to identify it in the admin panel.

integer

required

Action triggered when the tile is scanned: None, CheckIn, CheckOut, BookingCheckIn, EventCheckIn, ExtendBookingBy, RequestUrl, RedirectUrl, ResourceCleaned, BookResource, BookDesk, ShowNewBookingForm, UnlockAct365Door, UnlockDoorDeckDoor, UnlockKisiDoor, SmartLock, etc..

integer

required

Geofence precision level: Low, Medium, High, or VeryHigh. Higher precision requires the user to be closer to the tile coordinates.

Optional Fields

string

Unique tile identifier (GUID) auto-assigned on creation. Used to generate the QR code and NFC URL.

string

Parameters for the selected action. Format depends on the action type — e.g. a resource ID, a URL, or a resource ID|duration pair.

boolean

Whether to restrict the tile to a geographic area. When enabled, the tile only works if the user is within the configured radius of the tile’s coordinates.

boolean

Whether to also check the customer into the space when they scan the tile, regardless of the primary action.

string

Longitude of the tile’s installed location. Used for geofencing.

string

Latitude of the tile’s installed location. Used for geofencing.

integer

Custom maximum distance in meters from the tile’s coordinates. Overrides the precision preset when set.

string

Custom message shown to the user when the tile action completes successfully.

string

Custom error message shown to the user when the tile action fails.

integer[]

List of resources linked to this record.

integer[]

List of tariffs linked to this record.

integer[]

List of time passes linked to this record.

integer[]

List of floor plan desks linked to this record.

Code Examples

curl -X POST \
  "https://spaces.nexudus.com/api/sys/automationtiles" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "BusinessId": 0,
    "Name": "",
    "Action": 0,
    "GeofencePrecission": 0
}'

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

const data = await response.json();

import requests

response = requests.post(
    'https://spaces.nexudus.com/api/sys/automationtiles',
    headers={
        'Authorization': 'Bearer YOUR_TOKEN',
        'Content-Type': 'application/json'
    },
    json={
        'BusinessId': 0,
        'Name': '',
        'Action': 0,
        'GeofencePrecission': 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 automationtile was created successfully.

array

null on success.

Example Response

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

Update AutomationTileUpdate an existing AutomationTile record.

Create AutomationTile

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

import requests

url = "https://spaces.nexudus.com/api/sys/automationtiles"

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

fetch('https://spaces.nexudus.com/api/sys/automationtiles', 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

Enums

Request Body

Required Fields

Optional Fields

Code Examples

Response

200

400

​Authentication

​Enums

​Request Body

​Required Fields

​Optional Fields

​Code Examples

​Response

​200

​400

Authentication

Enums

Request Body

Required Fields

Optional Fields

Code Examples

Response

200

400