Linear Integration

Automatically create Linear issues from feedback.

Setup

Step 1: Get Webhook URL

1. Go to Linear Settings → API
2. Create a new webhook or use incoming webhook URL
3. Copy the URL

Step 2: Connect to Annot8

1. Go to Integrations in Annot8
2. Click Linear
3. Paste your webhook URL
4. Click Connect

Issue Creation

When feedback is received, a Linear issue is created with:

• Title - Summary of the feedback
• Description - Full feedback content
• Link - Reference to the original page

Configuration

Default Project

Set which Linear project receives new issues:

1. Configure in the Linear webhook settings
2. Or set in Annot8 integration settings

Labels

Automatically apply labels to created issues:

• feedback
• from-annot8

Priority Mapping

Map Annot8 priority to Linear priority:

Two-Way Sync

When issues are resolved in Linear, they can be marked as resolved in Annot8:

1. Enable Two-way sync in settings
2. Configure Linear webhook to ping Annot8
3. Issue status updates flow both ways

Best Practices

1. Use a triage project - Review before moving to sprints
2. Apply labels - Filter feedback issues easily
3. Link to context - Always include the page URL
4. Set up views - Create a saved view for feedback issues