Skip to content

Automation rules

Goal

Create event-driven rules that run safe actions only — notify, set field, tag, create draft, or require approval. Automation never auto-posts or pays.

Who it is for

Users with automation.view / automation.manage. Tenant admins with automation.admin own Automation setup (limits and trigger-type catalog).

Preconditions

  • Module automation enabled.
  • Trigger types / limits configured under Administration → Automation setup when you need custom catalogs or higher rule caps.

Steps — rules

  1. Open Administration → Automation.
  2. Choose New (automation.manage) or edit a row.
  3. Set Name, Event, optional Conditions (field / op / value; ops include eq, ne, gt, gte, lt, lte, contains, in, exists).
  4. Add Actions from the safe list only: notify, set_field, tag, create_draft, require_approval. Action params are JSON.
  5. Toggle Active, Save. Open Runs on a rule to inspect execution history.

Steps — setup (automation.admin)

  1. Open Administration → Automation setup.
  2. Set max rules, run retention days, max runs per hour, and whether only safe actions are allowed.
  3. Maintain Trigger types catalog as needed.

Result

Matching events enqueue runs under the configured limits. Unsafe action types are rejected.

Hard stops

SymptomCauseWhat to do
Action not permittedType outside safe whitelistUse only notify / set_field / tag / create_draft / require_approval
Rule limit reachedTenant max rules hitDeactivate unused rules or raise limit in Automation setup
422 on paramsInvalid JSON / missing fieldsFix paramsText and required condition fields

BlueMatrix Help — product documentation for tenants