Skip to main content
A Trigger in Omneo is an event-driven Reaction. It listens for one platform event, and every time that event fires, it runs its actions against the subject the event carries. Triggers are the reaction type to reach for when something happened and you want to respond to it.

How a Trigger runs

  1. Something happens in Omneo and an event is dispatched, for example transaction.created.
  2. Omneo finds every active Trigger listening for that event name.
  3. Each one runs its action chain against the event’s context, the payload describing what happened.
The subject is not something you configure. It arrives with the event: a transaction.created event carries the transaction and the profile it belongs to, so the Trigger’s actions have a profile to act on without looking anything up. One event fires all the Triggers watching it, and each runs independently. Two Triggers on profile.updated do not see or block each other.

What a Trigger is made of

There is no query and no schedule. If you find yourself wanting either, you want an Automation instead.

The events you can listen for

Any of the following can be a Trigger’s trigger value. For what each one’s context contains, see the matching section of Event Contexts.

Profiles and identity

profile.created profile.updated profile.merged profile.deleted identity.created balance.updated address.created address.updated profile.address.created profile.address.updated profile.address.deleted attributes.date.created attributes.date.updated attributes.date.deleted attributes.date.linked attributes.date.unlinked custom-field.created custom-field.updated custom-field.deleted

Transactions and orders

transaction.created transaction.updated transaction.deleted transaction.received transaction.resent transaction.sync transaction.recalculate transaction.points.issued transaction.tier-points.issued transaction.profile.unattached transaction-item.created transaction-item.resent transaction-item.sync transaction-claim.claimed transaction-claim.failed order.created order.updated order.deleted order.resent order-item.created

Incentives

reward.created reward.updated reward.deleted reward.extended reward.before.notify reward-definition.created reward-definition.updated benefit.created benefit.updated benefit.deleted benefit.expired benefit.code.allocated benefit-definition.created benefit-definition.updated benefit-definition.deleted point.created point-definition.created point-definition.updated point-definition.deleted credit.created credit.updated credit.deleted credit.extended credit.released redemption.created

Tiers and achievements

tier.achieved tier.progressed tier.maintained tier.switched tier.lost tier-point.created tier-definition.created tier-definition.updated tier-definition.deleted achievement.unlocked

Lists, products, ratings, and interactions

product-list.created product-list.updated product-list.deleted product-list-item.created product-list-item.updated product-list-item.deleted product-list-item.linked product-list-reservation.created product-list-reservation.updated product-list-reservation.deleted product-list-share.created product-list-share.deleted list-definition.created list-definition.updated product.created product.updated product.deleted rating.created rating.updated share.created share.updated share.deleted interaction.created

Appointments

appointment.created appointment.updated appointment.confirmed appointment.arrived appointment.completed appointment.cancelled appointment.rejected appointment.deleted

Groups and connections

group.profile.add group.profile.remove connection.created connection.updated connection.deleted

Configuration and reference data

location.created location.updated location.deleted region.created region.updated country.created country.updated rate.created rate.updated aggregation.updated notification.created profile-temporary.created profile.before.update

The ones you will reach for most

profile.before.update fires before the write rather than after, so its actions can influence what is saved. Treat it differently from the others: it is not a notification that something happened.

Data available to a Trigger

Filters and action arguments read from the event’s Event Context: the profile, the object that triggered the event, and related data such as aggregations, tags, statuses, and tier. Events that describe a change also carry what changed. profile.updated includes changes and originals, which is how a Trigger can act on a transition rather than a state, for example “the profile just entered this tier” rather than “the profile is in this tier”. See Event Contexts for the full reference.