Integration Webhooks
Enable triggering of integration workflows via webhook calls from the Portal UI. Users can manually trigger integration execution either without additional context (default mode) or with event data passed from the event details.
Scope:
- Webhook configuration stored per integration (webhook URL, bearer token, enabled status)
- Two trigger modes: default (no payload) and event context (event details as payload)
- Trigger buttons in integration listing, event listing, and event detail pages
- New user permission: can_trigger_integrations
- Webhook execution history tracked with full audit trail
- Standard Webhooks specification, bearer token authentication
- No automatic retry on failure - display error in UI, allow manual retry
- Out of scope: Integration platform webhook receivers and workflow execution
Implementation Notes
The Portal API will make outbound HTTP POST requests to configured webhook URLs following the Standard Webhooks specification. The integration platforms (external systems) must implement webhook receivers that: - Accept POST requests with optional JSON payload - Validate bearer token authentication - Trigger appropriate integration workflow execution - Return success/error status codes
This epic focuses on the Portal-side implementation only.
Tasks
| Task | Description |
|---|---|
| Add Webhook Database Schema | Add database models to support webhook configuration per integration, execution ... |
| Implement Webhook API Endpoints | Create REST API endpoints for managing webhook configurations and triggering web... |
| Implement Webhook Execution Service | Create service layer to execute webhook calls following the Standard Webhooks sp... |
| Add Webhook Configuration UI | Add admin interface for configuring webhook settings per integration in the inte... |
| Add Webhook Trigger Buttons | Add trigger buttons in integration listing and event views to manually execute w... |
| Add Webhook Execution History UI | Display webhook execution history with full audit trail including request/respon... |
| Implement Trigger Permission System | Add new user permission for triggering integration webhooks, separate from admin... |