​

Automation Triggers

Triggers define when an automation runs. Alguna supports event-based triggers that respond to billing events and schedule-based triggers for time-based workflows.

---

​

Configuring Triggers

​

Create an Automation with Triggers

1. Navigate to Automations in the dashboard
2. Click Create Automation
3. In the Trigger section, choose:
   • Event-based: Run when a billing event occurs
   • Schedule-based: Run at specific times
4. Configure trigger settings
5. Add actions and conditions
6. Click Save

---

​

Event Triggers

Event triggers fire when specific actions occur in your billing system.

​

Available Events

​

Subscription Events

​

Invoice Events

​

Payment Events

​

Other Events

​

Configuring Event Triggers

1. Select Event-based trigger
2. Choose the event type from the dropdown
3. Optionally add filters to narrow which events trigger the automation

​

Filters

Filter which events trigger the automation:

---

​

Schedule Triggers

Schedule triggers run automations at specified times.

​

Interval-Based

Run at regular intervals:

​

Cron-Based

Use cron expressions for precise scheduling: Cron format: minute hour day-of-month month day-of-week

​

Calendar-Based

Human-readable calendar triggers:

---

​

Trigger Context

Each trigger provides context data accessible in automation steps:

​

Event Trigger Context

When an event triggers the automation, you can access:

• Event type and timestamp
• Related object data (invoice, subscription, payment, etc.)
• Customer information
• Associated metadata

​

Schedule Trigger Context

For scheduled triggers:

• Scheduled run time
• Actual run time
• Run number (for tracking)

---

​

Common Trigger Patterns

​

Send Reminder on Invoice Issued

1. Trigger: invoice.issued
2. Action: Send email to customer with invoice details

​

Update CRM on Subscription Activated

1. Trigger: subscription.activated
2. Action: Send webhook to CRM with subscription details

​

Weekly Revenue Report

1. Trigger: Schedule - Every Monday at 9 AM
2. Action: Send report email to finance team

​

Notify Sales on Large Payment

1. Trigger: payment.created
2. Filter: Amount > $10,000
3. Action: Send Slack notification to sales channel

---

​

Best Practices

---

​

Viewing Trigger History

1. Navigate to Automations → [Automation Name]
2. Click the History tab
3. View recent executions:
   • Trigger event/schedule
   • Execution status
   • Timestamp
   • Actions performed

---

​

Troubleshooting

​

Trigger Not Firing

1. Verify the automation is Active
2. Check that the event type matches exactly
3. Review filters - they may be too restrictive
4. Confirm the event is actually occurring in your account

​

Automation Runs Too Often

1. Add filters to narrow the trigger conditions
2. Consider using debouncing for rapid-fire events
3. Review if multiple automations overlap

​

Schedule Not Running

1. Verify the cron expression is correct
2. Check timezone settings
3. Confirm the automation is active

---

​

Next Steps