micsapp Linear Webhooks & Events
Overview
Set up and handle Linear webhooks for real-time event notifications.
Prerequisites
- Linear workspace admin access
- Public endpoint for webhook delivery
- Webhook signing secret configured
Instructions
- Step 1: Create Webhook Endpoint
- Step 2: Event Processing Router
- Step 3: Business Logic Handlers
- Step 4: Register Webhook in Linear
- Step 5: Local Development with ngrok
- Step 6: Idempotent Event Processing
For full implementation details and code examples, load:
Read(${CLAUDE_SKILL_DIR}/references/implementation-guide.md)
Error Handling
| Error | Cause | Solution |
|---|---|---|
Invalid signature |
Wrong secret or tampering | Verify webhook secret |
Timeout |
Processing too slow | Use async queue |
Duplicate events |
Webhook retry | Implement idempotency |
Missing data |
Partial event | Handle gracefully |
Resources
Next Steps
Optimize performance with linear-performance-tuning.
Output
- Configuration files or code changes applied to the project
- Validation report confirming correct implementation
- Summary of changes made and their rationale
See Linear implementation details for output format specifications.
Examples
Basic usage: Apply linear webhooks events to a standard project setup with default configuration options.
Advanced scenario: Customize linear webhooks events for production environments with multiple constraints and team-specific requirements.