Connect a change to an action
Event-triggered automations react when something happens, such as a Salesforce field changing or a new record appearing. Use them to turn a relevant change into the research, signal, or follow-up your configured workflow provides.
Organization administrators open Org settings → Event triggers. The four tabs describe the flow:
- Definitions: the conditions that identify an event.
- Triggers: the actual events that were detected.
- Consumers: the actions subscribed to an event type.
- Runs: each consumer's execution for a trigger. One trigger can lead to several runs when multiple consumers match.
Creating a definition identifies what to watch. Attach the appropriate consumer to make an action follow. For recurring work on a schedule, see Agents.
Define and preview a Salesforce event
- In Definitions, select Create definition.
- Enter a recognizable Label and review its Event type. Consumers use that event type to match the event, so keep it consistent with the action you intend to attach.
- Choose the Salesforce object and Operation: Update, Create, or Create or update.
- Set the field condition and relevant values. Update conditions can specify an Old value and New value; Create supports multiple field conditions.
- Choose a Lookback window and select Test. Review the match count and sample records.
- When the conditions are correct, select Save.
The definition test previews recent matching records without saving the definition or firing its actions. A newly saved definition is enabled, so prepare the intended workflow and review any consumers already using its event type.
Update-based conditions require the relevant Salesforce field history. Resolve a not tracked warning by enabling field-history tracking in Salesforce or choosing a supported field. Some system and legacy definitions are read-only.
Attach the action that should follow
- Open Consumers and select Create consumer.
- Enter a Label and choose the matching Event Type.
- Choose the available Action Type. If it requires a workflow, select the intended Workflow.
- Review any action-specific configuration and select Save.
A newly saved consumer is enabled. Review its audience, outputs, and record-changing actions before saving. If the workflow or action type you need is unavailable, chat with us to configure it.
No action wired in Definitions means an event can fire without a connected action. Check the event type and its consumers when detection works but nothing follows.
The Enabled columns show the definition and consumer statuses. These cells are read-only. For a consumer connected to an automation, use Open workflow, then Pause or Resume when available. This controls the automation and its event subscription together. An automation may need its setup completed before it can resume. For other definition or consumer status changes, contact support.
Test the workflow on detected events
For a consumer linked to a supported workflow, select Test workflow in its row.
Email and Slack steps can send real messages during a test. Those messages are marked [TEST RUN]. Review the workflow's recipients and channels before running a test, even when the interface describes testing as read-only.
- Find representative triggers using the status and Source Record ID filters.
- Select up to 10 triggers and choose Run Test.
- Review Test Results, including each result and any errors. Open a result to inspect the detail.
- Use Rerun Test to choose another sample after reviewing or updating the workflow.
Test mode simulates record-changing actions, with the email and Slack notification exceptions above. It helps you evaluate the workflow's logic; the definition's separate Test checks which source records match the event conditions.
Use Open workflow to inspect the linked workflow. If it needs changes, review the saved and active version before expecting subsequent live runs to use them.
Follow a trigger through its run
Start in Triggers to check that the source change was detected. Open the source record or payload to confirm it is the event you expected.
Then open Runs and inspect the associated consumer. Review Status, Error, Action Taken, and Result. The details also identify the workflow version when available.
A detected trigger and a successful action are separate outcomes. Several consumers can react differently to the same trigger, and a workflow can determine that no action is appropriate. Read the result before treating a quiet outcome as a failure.
Resolve missing or failed actions
- No trigger: check the definition's status, source object, operation, field values, and Salesforce history support. Use the definition Test to check recent matches.
- Trigger but no action: check for No action wired, a missing consumer, a mismatched event type, or a disabled consumer.
- Failed run: read the error and result, confirm the linked workflow and its active version, then test an appropriate sample after correcting the cause.
A successful test does not establish that a failed live run has recovered. If an event needs live reprocessing, contact support with the definition, source record, consumer, run time, and expected result.
For events from another platform or an internal system, chat with us about connecting that source. API setup separately explains publishing signals from your own tools.