Looking to understand automation concepts? Start with the Automation System guide to learn about event-driven automation and AI integration.
Record Triggers
Record triggers respond to changes in your data, forming the foundation of most automation workflows.Record is Created
Record is Created
Purpose: Trigger when new records are added to your system.How it works: Fires immediately when a new record is created in any app, element, or task, providing access to all field data from the new record.Configuration:Common Use Cases:
- Keep data consistent: Optional checkbox to lock user interaction during automation execution
- Add Changed Condition: Filter which record creations should trigger the automation
- Where conditions: Set criteria like field values, user who created the record, or other attributes
- Customer Onboarding: Welcome new customers with account setup, documentation, and team assignments
- Lead Processing: Qualify and route new leads based on source, value, or characteristics
- Project Initialization: Create project templates, assign teams, and set up tracking when new projects are added
- Compliance Logging: Document new record creation for audit trails and regulatory requirements
- Notification Workflows: Alert stakeholders when critical records are created
- All field values from the new record
Record is Updated
Record is Updated
Purpose: Trigger when existing records are modified.How it works: Fires when record field values change, with options to specify which field changes should trigger the automation.Configuration:Common Use Cases:
- Keep data consistent: Lock user interaction during execution
- Add Changed Condition: Specify which fields trigger the automation when changed
- Changed Fields: Select specific fields to monitor (e.g., Status, Priority, Assigned User)
- Where conditions: Additional criteria that must be met for the trigger to fire
- Status Change Workflows: Route records through approval processes when status changes
- Escalation Management: Alert managers when priority levels increase
- Progress Tracking: Update related records when project milestones are reached
- Notification Cascades: Inform stakeholders when critical fields are modified
- Data Synchronization: Update external systems when key fields change
- All field values from the updated record
Approval Process Status Updated
Approval Process Status Updated
Purpose: Trigger when approval workflow statuses change.How it works: Monitors approval processes and fires when status transitions occur (Created, Step Approved, Cancelled, Denied, Final Approval).Configuration:Common Use Cases:
- Approval Process: Select which approval process to monitor
- Status: Choose specific status changes to trigger on:
- Created: When approval process begins
- Step Approved: When individual approval steps complete
- Cancelled: When approval process is cancelled
- Denied: When approval is rejected
- Final Approval: When all approvals are complete
- Where conditions: Additional filtering based on approval details
- Post-Approval Processing: Execute purchase orders, contracts, or projects after final approval
- Rejection Handling: Route denied requests back to originators with feedback
- Escalation Management: Alert higher authorities when approvals are delayed
- Compliance Documentation: Log approval decisions for audit trails
- Workflow Continuation: Trigger next phase of business processes after approval
trigger.status
: New approval status- All field values from the record being approved
Agent Conversation Ended
Agent Conversation Ended
Purpose: Trigger when AI agent conversations complete.How it works: Fires when agent interactions finish, providing access to conversation transcripts and metadata for further processing.Configuration:Common Use Cases:
- Conversation Type: Filter by conversation channel:
- Teams: Microsoft Teams conversations
- Voice: Phone call conversations
- Timeout Duration: Set how long to wait after conversation inactivity before considering it ended
- Changed Fields: Monitor specific fields that may change during conversations
- Where conditions: Filter based on conversation attributes or outcomes
- Call Analytics: Analyze phone conversations for sentiment, keywords, and outcomes
- Follow-up Automation: Schedule follow-up tasks based on conversation content
- CRM Updates: Update customer records with conversation summaries and next steps
- Quality Assurance: Route conversations for review based on specific criteria
- Agent Performance: Capture workflow statistics and grade agent performance
- Reporting: Generate conversation reports and performance metrics
trigger.Conversation Type
- Channel (Teams, Voice, etc.)trigger.transcript
- Full conversation transcript- All field values from the record the conversation was added to
Communication Triggers
Communication triggers respond to messaging and collaboration activities.Comment Added
Comment Added
Email Received
Email Received
Purpose: Trigger when emails are received at configured addresses.How it works: Monitors dedicated email addresses and fires when new emails arrive, providing access to email content, attachments, and sender information.Configuration:Common Use Cases:
- Email Address: Configure or create new email addresses to monitor
- Create New Email: Generate dedicated email addresses for specific automations
- Email Format: Typically follows pattern like
testing@elementum.elementum.io
- Support Ticket Creation: Convert emails into support tickets automatically
- Lead Capture: Process inquiry emails into lead records
- Invoice Processing: Handle vendor invoices sent via email
- Document Processing: Process emailed documents and attachments
- Customer Communication: Route customer emails to appropriate teams
trigger.email_id
- Unique email identifiertrigger.sender_email
- Email address of sendertrigger.sender_name
- Name of sender (if available)trigger.subject
- Email subject linetrigger.body
- Email content (text and HTML)trigger.attachments
- Array of attached filestrigger.timestamp
- When email was received
File Triggers
File triggers respond to document uploads and attachments.Attachment is Added
Attachment is Added
Purpose: Trigger when files are uploaded to records.How it works: Fires when attachments are added to any record, providing access to file content and metadata for processing.Configuration:Common Use Cases:
- No specific configuration required: This trigger automatically monitors all file uploads
- Add Changed Condition: Filter based on file type, size, or record attributes
- Where conditions: Specify criteria for which attachments should trigger the automation
- Document Processing: Extract data from uploaded contracts, invoices, or reports
- File Validation: Check file formats, sizes, or content before processing
- Compliance Scanning: Scan documents for sensitive information or compliance issues
- Workflow Initiation: Start approval processes when key documents are uploaded
- Data Extraction: Pull information from documents into record fields
trigger.Name
: Original filenametrigger.Description
: Attachment descriptiontrigger.Media Type
: File extension/formattrigger.URL
: File URLtrigger.Size
: Size of uploaded file- All field values from the record the file was attached to
Scheduled Triggers
Scheduled triggers execute automations based on time or external data events.Data Mine
Data Mine
Purpose: Trigger when external data collection processes complete.How it works: Fires when data mining operations finish, providing access to newly collected data for processing and analysis.Configuration:Common Use Cases:
- Select a Data Mine: Choose which data mining process to monitor
- Trigger Options:
- Trigger when data meets requirement: Fire when specific data conditions are met
- Trigger when data no longer meets requirement: Fire when conditions are no longer satisfied
- Data Processing: Process newly collected external data
- Alert Systems: Alert teams when data thresholds are crossed
- Report Generation: Create reports from fresh data collections
- Integration Workflows: Sync external data with internal systems
- Quality Monitoring: Monitor data quality and completeness
- All the fields from the record the data mine was triggered for
Survey
Survey
Purpose: Trigger when survey responses are submitted.How it works: Fires when survey forms are completed, providing access to response data for analysis and follow-up actions.Configuration:Common Use Cases:
- Survey: Select which survey to monitor for responses
- Add Changed Condition: Filter responses based on specific criteria
- Changed Fields: Monitor specific survey fields
- Where conditions: Set criteria for which responses trigger the automation
- Response Processing: Analyze and categorize survey responses
- Follow-up Actions: Trigger follow-up based on response content
- Alert Systems: Alert teams to negative feedback or critical responses
- Data Analysis: Process survey data for reporting and insights
- Customer Service: Route dissatisfied customers to support teams
- All the fields from the survey response
- All the fields from the record the survey was added to
Advanced Triggers
Advanced triggers provide specialized functionality for complex workflows.On-Demand Trigger
On-Demand Trigger
Purpose: Create custom triggers with configurable inputs and outputs.How it works: Allows creation of reusable automation components that can be triggered manually or by other automations with custom parameters.Configuration:Common Use Cases:
- Configure Inputs: Define input parameters that can be passed to the automation
- Input Name: Descriptive name for the parameter
- Field Type: Data type (Text, Number, Date, etc.)
- Default Value: Optional default value
- Required: Whether the input is mandatory
- Multiple: Whether multiple values are allowed
- Reusable Workflows: Create automation templates that can be used across multiple processes
- Manual Processing: Allow users to trigger specific workflows with custom parameters
- Integration Points: Create endpoints for external systems to trigger automations
- Batch Operations: Process multiple items with consistent logic
- Custom Business Logic: Implement specialized workflows that require input parameters
- All configured input parameters as variables
Quick Trigger Categories
Record Events
Record Created, Updated, Approval Status
Communication
Comment Added, Email Received
File Operations
Attachment Added
Scheduled Events
Time-Based, Data Mine, Survey
Agent Interactions
Agent Conversation Ended
Custom Triggers
On-Demand Trigger
Choosing the Right Trigger
Event-Driven vs. Scheduled
Use Event-Driven Triggers When:- You need immediate response to system changes
- Processing should happen as data changes
- Real-time notifications are required
- Workflow advancement depends on user actions
- Processing can happen in batches
- Regular maintenance tasks are needed
- Reports should be generated periodically
- Reminders need to be sent at specific times
Single vs. Multiple Triggers
Single Trigger Automations:- Focused, specific responses to events
- Easier to debug and maintain
- Clear cause-and-effect relationships
- Consolidated logic for similar events
- Reduced automation sprawl
- Shared processing for related triggers
Configuration Best Practices
1
Be Specific with Conditions
Use “Where” conditions to filter triggers precisely, avoiding unnecessary automation executions
2
Consider Performance Impact
Avoid overly broad triggers that fire frequently without adding value
3
Plan for Scale
Design triggers that will work efficiently as your data volume grows
4
Test Thoroughly
Verify triggers fire under expected conditions and don’t fire when they shouldn’t
Troubleshooting Common Issues
Trigger Not Firing
Configuration Issues
Configuration Issues
Check:
- Automation is published (not in draft mode)
- Trigger conditions are correctly configured
- “Where” conditions are not too restrictive
- Field names match exactly (case-sensitive)
Data Issues
Data Issues
Check:
- Test data meets all trigger conditions
- Required fields have values
- Data types match expected formats
- User permissions allow trigger execution
Timing Issues
Timing Issues
Check:
- Scheduled triggers have correct time zones
- Time-based conditions use appropriate date formats
- System maintenance windows don’t conflict
Unexpected Trigger Behavior
Too Many Executions
Too Many Executions
Solutions:
- Add more specific “Where” conditions
- Use “Changed Fields” to limit update triggers
- Consider consolidating similar triggers
- Implement rate limiting where appropriate
Missing Executions
Missing Executions
Solutions:
- Verify all conditions are necessary
- Check for conflicting conditions
- Test with simplified trigger configuration
- Review automation execution history
Ready to build automations with these triggers? Visit the Automation System guide for complete workflow examples and the Actions Reference for available actions.
trigger.Message
: Full comment contenttrigger.Author
: User who posted the comment