Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.omneo.io/llms.txt

Use this file to discover all available pages before exploring further.

The Automations API configures scheduled reactions: logic that runs on a recurring schedule or at a specific time, rather than in response to a live event. See Reactions for a conceptual overview of both automations and event-driven triggers.

Automations vs triggers

TypeWhat fires itConfigured via
TriggerA platform event (e.g., transaction.created)Triggers API
AutomationA schedule (daily, weekly, specific date)Automations API
Both use the same action structure. The difference is the trigger field value, which for automations specifies the schedule rather than an event name.

Automation attributes

AttributeDescription
id INTEGERThe unique Omneo ID of the automation
name STRINGThe display name of the automation
trigger STRINGThe schedule definition (a cron expression or schedule keyword)
description STRINGA description of what this automation does
notes STRINGInternal notes about the automation
is_active BOOLEANWhether the automation is active and will run on schedule
actions ARRAYAn ordered array of actions that execute when the automation fires

Actions

Automation actions use the same structure as trigger actions. Each action has a uuid (action type), sort_order, and arguments array. See Triggers for the full action type reference.

Common automation patterns

  • Win-back: weekly automation that finds lapsed profiles and issues a re-engagement benefit
  • Birthday: daily automation that issues birthday rewards to profiles with birth_date today
  • Expiry reminder: daily automation that finds rewards expiring within 14 days and sends a reminder via target