Skip to main content
POST
/
api
/
sys
/
automationtiles
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
}
'
{
  "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:
ActionActionParameters format
CheckIn / CheckOut / EventCheckInNot required
BookingCheckIn / ResourceCleaned / ShowNewBookingFormResource ID
BookResourceResource ID | default booking length in minutes (default 60)
BookDeskDesk (floor plan item) ID | default booking length in minutes (default 480)
ExtendBookingByNumber of minutes to extend
RequestUrlTarget URL for the HTTP POST request
RedirectUrlURL to redirect the user to
UnlockAct365Door / UnlockDoorDeckDoor / UnlockKisiDoorDoor ID from the access-control provider
SmartLockSmartalock 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

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

​
Request Body

​
Required Fields

​
BusinessId
integer
required
ID of the business linked to this record.
​
Name
string
required
Tile name used to identify it in the admin panel.
​
Action
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..
​
GeofencePrecission
integer
required
Geofence precision level: Low, Medium, High, or VeryHigh. Higher precision requires the user to be closer to the tile coordinates.

​
Optional Fields

​
TileNumber
string
Unique tile identifier (GUID) auto-assigned on creation. Used to generate the QR code and NFC URL.
​
ActionParameters
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.
​
EnableGeofence
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.
​
CheckCustomerIn
boolean
Whether to also check the customer into the space when they scan the tile, regardless of the primary action.
​
Longitude
string
Longitude of the tile’s installed location. Used for geofencing.
​
Latitude
string
Latitude of the tile’s installed location. Used for geofencing.
​
MaxDistanceMeters
integer
Custom maximum distance in meters from the tile’s coordinates. Overrides the precision preset when set.
​
SuccessMessage
string
Custom message shown to the user when the tile action completes successfully.
​
ErrorMessage
string
Custom error message shown to the user when the tile action fails.
​
Resources
integer[]
List of resources linked to this record.
​
Tariffs
integer[]
List of tariffs linked to this record.
​
TimePasses
integer[]
List of time passes linked to this record.
​
FloorPlanDesks
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
}'

​
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 automationtile was created successfully.
​
Errors
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

​
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.
​
WasSuccessful
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
}