Event Trigger
Start workflows when system events occur
The Event Trigger node starts a workflow when a specific system event occurs. It's the most common trigger type, used for reactive automations that respond to meetings and other activities.
Overview
| Property | Value |
|---|---|
| Category | Trigger |
| Node ID | ds.eventTrigger.perItem.in0.success1.error0 |
| Input Ports | 0 |
| Success Outputs | 1 |
| Error Outputs | 0 |
| Execution Mode | Per-item |
Configuration
| Parameter | Type | Required | Description |
|---|---|---|---|
event | Select | Yes | The event type to listen for |
Event Types
| Event | Timing | Description |
|---|---|---|
MEETING_START_MINUS_24H | 24 hours before | Pre-meeting preparation window |
MEETING_START_MINUS_6H | 6 hours before | Day-of preparation |
MEETING_START_MINUS_1H | 1 hour before | Last-minute checks |
MEETING_START_MINUS_30M | 30 minutes before | Immediate preparation |
MEETING_START_MINUS_15M | 15 minutes before | Final reminders |
MEETING_START | At meeting start | Meeting kick-off |
MEETING_ENDED | When meeting ends | Post-meeting processing |
MEETING_ENDED_FOR_DEAL_ROOM | When meeting ends (deal room context) | Deal-specific processing |
MANUAL | User clicks Trigger | Testing and ad-hoc execution |
Output Schema
The Event Trigger outputs a trigger object:
{
"meetingPlanId": "mp_abc123def456",
"dealRoomId": 12345,
"organizationId": 67890,
"event": "MEETING_ENDED",
"firedAt": "2024-01-15T14:30:00.000Z"
}
| Field | Type | Description |
|---|---|---|
meetingPlanId | string | ID of the meeting that triggered the event (UUID) |
dealRoomId | number | null | ID of the associated deal room (if applicable) |
organizationId | number | Your organization's ID |
event | string | The event type (matches your configuration) |
firedAt | string (ISO 8601) | Timestamp when the event fired |
Examples
Basic Example: Post-Meeting Follow-up
Trigger a workflow when any meeting ends:
Configuration:
- Event:
MEETING_ENDED
Usage in downstream node:
trigger.meetingPlanId // Access the meeting ID
Advanced Example: Pre-Meeting Briefing
Generate a briefing 1 hour before meetings:
Configuration:
- Event:
MEETING_START_MINUS_1H
Workflow pattern:
[Event Trigger: MEETING_START_MINUS_1H]
│
▼
[Load Meeting] ──── Fetch attendees, context
│
▼
[AI Agent] ──────── Research attendees, generate briefing
│
▼
[Slack Post] ────── Send briefing to rep
Testing with Trigger Execution
Use the trigger execution feature to test workflows without waiting for real events:
Testing process:
- Keep your Event Trigger set to your desired event type (e.g.,
MEETING_ENDED) - Click the Trigger button in the toolbar
- In the trigger execution modal, fill in the form with your test data
- Click Execute
The workflow executes with your provided data. No need to switch event types—test and release with the same configuration.
Best Practices
1. Choose the Right Event Timing
| Goal | Recommended Event |
|---|---|
| Post-meeting follow-up | MEETING_ENDED |
| Quick recap while fresh | MEETING_ENDED |
| Pre-meeting preparation | MEETING_START_MINUS_1H or MINUS_24H |
| Real-time meeting actions | MEETING_START |
| Testing/debugging | MANUAL |
2. Handle Missing Data
Not all events have all data. For example, MEETING_START_MINUS_24H fires before the meeting has a transcript:
// Check if transcript exists before using
has(json.callRecording) && json.callRecording.transcript != ""
3. Use Deal Room Context When Needed
For deal-specific workflows, use MEETING_ENDED_FOR_DEAL_ROOM:
- Only fires for meetings associated with deal rooms
dealRoomIdis always populated- Better for CRM update workflows
4. Development Workflow
- During development: Use
MANUALevent for quick testing - Before releasing: Switch to the real event type
- After releasing: Test with a real meeting to verify
Common Issues
Workflow doesn't trigger
Symptoms: Meeting ends but workflow doesn't run
Solutions:
- Verify workflow is Active (not Draft)
- Check the event type matches your expectation
- Confirm the meeting is tracked in Decision Site
- Review execution history for errors
Wrong meeting data
Symptoms: Workflow runs but with unexpected meeting
Solutions:
- Verify
meetingPlanIdis correct in trigger output - Check if duplicate meetings exist
- Ensure Load Meeting node uses
trigger.meetingPlanId
Multiple executions for same meeting
Symptoms: Workflow runs more than once for a meeting
Solutions:
- Check for multiple versions of the workflow with Active status
- Review trigger configuration for duplicates
- The system should deduplicate—contact support if persists
Related Nodes
- Scheduled Trigger - Time-based triggers
- Load Meeting - Fetch meeting data after trigger
Technical Details
Event Generation
Events are generated by the Decision Site system:
- Meeting events come from calendar integration and recording system
- Pre-meeting events are materialized by a scheduler looking ahead
- Manual events are created when user clicks the Trigger button
Deduplication
The system prevents duplicate executions:
- Key:
organizationId + workflowVersionId + meetingPlanId + event - Same event for same meeting = single execution
- Different workflow versions = separate executions
Event Ordering
Pre-meeting events fire in sequence:
-24H → -6H → -1H → -30M → -15M → START → ENDED
Each event is independent—missing one doesn't affect others.