Smart Values Reference

Smart values are dot-notation paths that resolve to runtime data during automation evaluation. They are used as the field in conditions and can be used in action config templates.

Available smart values vary by trigger type. Use the API endpoint to retrieve them dynamically:

GET /api/automation/smart-values/:triggerType
Authorization: Bearer <token>

Event Trigger Smart Values

Available for triggers: event.created, event.updated, event.deleted, event.starts_in, event.ends_in, relative_time_to_event

Path	Category	Description
event.title	Event	Event title/name
event.description	Event	Event description body
event.location	Event	Event location string
event.notes	Event	Event notes field
event.duration	Event	Duration in minutes (computed)
event.is_all_day	Event	Boolean — true if all-day event
event.color	Event	Event color identifier
event.status	Event	Event status string
event.calendar.id	Calendar	ID of the parent calendar
event.calendar.name	Calendar	Name of the parent calendar

Webhook Trigger Smart Values

Available for trigger: webhook.incoming

Path Pattern	Category	Description
webhook.data	Webhook	The entire JSON payload body
webhook.data.<key>	Webhook	Top-level key from the payload
webhook.data.<key>.<nested>	Webhook	Nested key using dot notation

Dot-Notation Path Traversal

PrimeCal resolves webhook.data.* paths at evaluation time using recursive property access. Paths are null-safe — a missing key evaluates as null/empty rather than throwing an error.

Example payload:

{
  "event": "order.completed",
  "data": {
    "order_id": "12345",
    "customer": {
      "id": "cust_789",
      "tier": "premium"
    },
    "total": 99.99,
    "status": "paid"
  }
}

Corresponding condition paths:

Path	Resolved Value
webhook.data.order_id	"12345"
webhook.data.customer.tier	"premium"
webhook.data.total	99.99
webhook.data.status	"paid"
webhook.data.customer.nonexistent	null

Scheduled Trigger Smart Values

Available for trigger: scheduled.time

The scheduled trigger fires without an associated event. Event-scoped smart values (event.*) are unavailable. Webhook smart values are also unavailable. Conditions in scheduled rules typically test against calendar state or time-based criteria.

Calendar Import Smart Values

Available for trigger: calendar.imported

Path	Category	Description
event.title	Event	Title of the imported event
event.calendar.name	Calendar	Name of the importing calendar

Runtime Config Availability

The /api/automation/smart-values/:triggerType endpoint returns the full list of valid smart value metadata for any trigger type, including field, label, description, and category. Use this endpoint to populate UI pickers or validate rule configs programmatically.

Request:

GET /api/automation/smart-values/event.created
Authorization: Bearer <token>

Response shape:

[
  {
    "field": "event.title",
    "label": "Event Title",
    "description": "Event title/name",
    "category": "Event"
  }
]

Returns 400 if the trigger type is not a valid TriggerType enum value.