Event Webhooks

Knapsack supports webhook events that trigger automated workflows (called "Knaps") based on specific activities. These events allow your Knaps to respond to real-time events in your connected systems.

Available Webhook Events

new_calendar_event

Triggered when a new calendar event is created in any connected calendar system.

Event Data:

• user_id: ID of the user who owns the calendar event
• calendar_event: Dictionary containing event details:
  • id or event_id: Unique identifier for the calendar event
  • title: Event title/subject
  • start_time: Event start time
  • end_time: Event end time
  • attendees: List of event attendees
  • location: Event location (if specified)

Use Cases:

• Automatically prepare meeting agendas
• Send event reminders to participants
• Schedule pre-meeting research tasks
• Update project management tools with meeting information

post_meeting_transcription

Triggered after a meeting transcript becomes available from any connected meeting platform (Zoom, Teams, etc.).

Event Data:

• user_id: ID of the user who participated in the meeting
• meeting_id: External meeting identifier
• transcript_id: ID of the completed transcript
• meeting_data: Dictionary with meeting details:
  • title: Meeting title
  • participants: List of meeting participants
  • duration: Meeting duration
  • platform: Meeting platform (Zoom, Teams, etc.)

Use Cases:

• Generate meeting summaries
• Extract action items from transcripts
• Update CRM systems with meeting outcomes
• Send follow-up emails with key decisions

post_emails_received

Triggered after new email(s) are received in connected email accounts.

Event Data:

• user_id: ID of the user who received the email(s)
• emails: List of received email objects:
  • id: Unique email identifier
  • subject: Email subject line
  • sender: Email sender information
  • recipients: List of email recipients
  • body: Email content
  • timestamp: When email was received
  • attachments: List of email attachments (if any)

Use Cases:

• Auto-categorize and prioritize emails
• Extract tasks from email content
• Update customer support tickets
• Generate automated responses for common inquiries

pre_calendar_event_start

Triggered approximately 1 hour before a calendar event is scheduled to start.

Event Data:

• user_id: ID of the user who owns the calendar event
• calendar_event: Dictionary containing event details:
  • id or event_id: Unique identifier for the calendar event
  • title: Event title/subject
  • start_time: Event start time
  • end_time: Event end time
  • attendees: List of event attendees
  • location: Event location (if specified)
• time_until_start: Minutes until the event starts (approximately 60)

Use Cases:

• Send pre-meeting preparation reminders
• Gather relevant documents for the meeting
• Check attendee availability
• Set up virtual meeting rooms

Event Handling

When a webhook event occurs:

1. Event Detection: Knapsack detects the event from connected systems
2. User Filtering: Only active Knaps for the relevant user are considered
3. Permission Checks: Knapsack verifies the user has permission to run the triggered Knaps
4. Execution: Eligible Knaps are queued for execution with the event data
5. Deduplication: Duplicate events are handled gracefully to prevent redundant executions

Setting Up Webhook Triggers

To configure a Knap to respond to webhook events:

1. Create or edit a Knap in the Knapsack interface
2. In the trigger settings, select "Event-based" instead of "Scheduled"
3. Choose one or more webhook events that should trigger the Knap
4. Configure any event-specific parameters
5. Save and activate the Knap

The Knap will automatically execute when the selected events occur, with access to all relevant event data for processing.