Custom Codes Mapping
Custom Event Mapping allows you to create personalized event codes alongside the 280+ official SIA alarm codes. This feature enables precise monitoring and alerting for equipment, zones, and scenarios specific to your installation.
Availability: This feature is available on Pro plan and above only.
Why Use Custom Codes?
Standard SIA codes are universal but generic. Custom codes let you:
Specific identification
TEMP_RACK1 instead of generic YT (System Trouble)
Intuitive naming
Use terminology that matches your organization
Equipment integration
Support non-standard or IoT devices
Clear descriptions
Provide context for responders
Example:
Instead of: YT (System Trouble)
Use: SRV_DOWN (Production server unreachable for 30 seconds)Accessing Custom Codes
Go to Delay Rules in your dashboard.
Click Create Rule or edit an existing rule.
Custom codes, if added, appear at the top of the SIA codes table.

Creating a Custom Code
Click + Custom Code in the toolbar to open the creation form.

Code Format
Length
2-10 characters
T1, TEMP_HIGH, DOOR_01
Characters
Uppercase A-Z, numbers 0-9, underscore
TEMP_1, DOOR_MAIN
Case
UPPERCASE only
β
TEMP_HIGH β temp_high
Spaces
Not allowed
β
TEMP_HIGH β TEMP HIGH
Note: You cannot use a code that already exists as an official SIA code (BA, FA, PA, etc.).
Description
Provide a clear, human-readable description (max 100 characters). This description is:
Displayed in your dashboard and event logs
Used in voice messages during calls
Included in technical emails
Good descriptions:
Call Action
Choose how the system should react when this code is received:
Delayed
Calls contacts after the configured delay
Instant
Calls contacts immediately
None
No call (use with Technical for email-only alerts)
Cancel
Cancels any pending delayed call
Technical Flag
The Technical checkbox sends an email to your technical contact. It can be combined with any call action:
Delayed
β
Call after delay + Email
Instant
β
Immediate call + Email
Cancel
β
Cancel pending call + Email (for audit)
None
β
Email only (no call)
Editing a Custom Code
Find the code in the Custom Codes section.
Click the βοΈ Edit icon.
Modify the description, call action, or technical flag.
Click Save Changes.
Note: The code name itself cannot be edited. To change a code name, delete it and create a new one.
Deleting a Custom Code
Click the ποΈ Delete icon next to the code.
Confirm deletion.
Click Save Rule to persist changes.
Plan Restrictions
Starter
β Ignored (codes can be created in the interface but are not processed)
Pro
β Fully supported
Business
β Fully supported
Important: On Starter plan, custom codes can be configured in the dashboard interface, but they are completely ignored by the system. Only official SIA codes are processed. Upgrade to Pro to enable custom event mapping.
Use Case: IT Server Monitoring
Scenario: You want to be called if a production server (#16) goes down and isn't restored within 30 seconds.
Configuration


Code
16_DOWN
Description
Production server unreachable - intervention required
Call Action
Delayed
Technical
β Checked
Delay Rule Settings
Delay: 30 seconds
Cancel code:
16_UP(server restored)
How It Works

Benefits
β 30-second grace period β Avoids false alarms for brief network hiccups
β Automatic cancellation β No call if server recovers in time
β Technical email β IT team always notified, even if cancelled
β Clear description β On-call technician knows exactly what's wrong
Mixing SIA and Custom Codes
You can freely mix official SIA codes and custom codes in the same delay rule:
Best Practices
Naming Conventions
Use a consistent pattern for your codes:
TYPE_LOCATION
TEMP_SRVR, DOOR_WH
EQUIPMENT_ZONE
SENS_ZN1, CAM_PARK
EVENT_DETAIL
FIRE_KTCHN, LEAK_BASE
Action Selection Guide
Critical
Instant
Fire, medical, security breach
Important
Delayed
Server down, door forced, temperature warning
Cancellation
Cancel
Server up, system disarmed, issue resolved
Information
None + Technical
Battery low, maintenance due, audit log
Documentation
Keep a record of your custom codes:
SRV_DOWN
Prod server unreachable
Data center
Delayed 30s
β
SRV_UP
Prod server restored
Data center
Cancel
β
TEMP_DC
Temp > 35Β°C
Data center
Instant
β
Troubleshooting
Custom code not working
Starter plan
Custom codes are ignored on Starter β upgrade to Pro
Code not saved
Click Save Rule after adding the code
Wrong delay rule
Verify the connection uses the correct delay rule
Cannot create custom code
Invalid format
Use only A-Z, 0-9, underscore (2-10 characters)
Code exists
Cannot use existing SIA codes or duplicate custom codes
Lowercase
Codes must be UPPERCASE
Technical email not received
Starter plan
Custom codes (including technical emails) require Pro plan or above
No technical contact
Configure email in connection's Advanced Settings
Check spam folder
Technical emails may be filtered
RΓ©ference
β Create your first delay rule β Public API Reference β Send custom codes via API
Last updated