Linear Integration
Dispatch integrates with Linear to receive webhook events when issues, comments, and projects change in your workspace.
Connecting Linear
- Navigate to your project's Sources page
- Click Connect Linear
- Authorize the Dispatch Linear OAuth app
- Select the events you want to receive
Dispatch will:
- Create a webhook endpoint with
provider = "linear" - Register a webhook on your Linear workspace pointing to your Dispatch endpoint
- Configure the endpoint to receive the selected event types
Supported Linear Events
The event type is extracted from the type field in the Linear payload.
| Event Type | Description |
|---|---|
Issue | Issue created, updated, or removed |
Comment | Comment created, updated, or removed |
IssueLabel | Label created or updated |
Project | Project created or updated |
ProjectUpdate | Project update posted |
Cycle | Cycle started, completed, or updated |
Team | Team settings changed |
User | User added or updated |
Signature Verification
Linear webhooks include a Linear-Signature header containing an HMAC-SHA256 hex digest of the request body. Dispatch verifies this against the endpoint's signing secret.
Linear-Signature: <hex-encoded-hmac>
When connecting via OAuth, Dispatch automatically sets and stores the signing secret.
Auto-Formatted Embeds
When no custom template is assigned, Dispatch auto-detects Linear payloads and generates specialized embeds:
Issue Events
- Shows issue title, status, priority, and assignee
- Includes team and project context
- Color-coded by priority (red for urgent, orange for high, blue for medium, gray for low)
- Shows what changed for update events
Comment Events
- Shows the comment text and the issue it was added to
- Includes the comment author
Project Updates
- Shows the project name and update content
Disconnecting
To disconnect a Linear workspace:
- Go to Sources and find the Linear endpoint
- Click Disconnect
- Dispatch removes the webhook from Linear and deactivates the endpoint