Linear Integration
Connect ProductBridge with Linear to track documentation tasks, link pages to issues, and keep your docs in sync with your development workflow.
curl -X POST https://api.productbridge.com/integrations/linear/webhook \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"event": "issue.linked",
"issue_id": "DOC-42",
"doc_id": "doc_789",
"timestamp": "2025-03-10T14:00:00Z"
}'
{
"status": "ok",
"message": "Webhook received",
"linked": true
}
{
"error": "Issue not found",
"code": "LINEAR_ISSUE_NOT_FOUND"
}
Overview
The Linear integration connects ProductBridge to your Linear workspace so you can link documentation pages to Linear issues, automate doc task creation, and keep your team aligned across both platforms.
You need workspace admin access in Linear to configure this integration.
Setup
Connect your Linear workspace
Navigate to Settings > Integrations > Linear in your ProductBridge dashboard.
Click Connect Linear and authorize ProductBridge via OAuth.
Linear's OAuth flow grants scoped access. ProductBridge only requests permissions for issues, comments, and webhooks.
Select your team
Choose the Linear team you want to sync with ProductBridge.
You can connect multiple teams and map each to a specific documentation section.
{
"linear_team": "Documentation",
"doc_section": "getting-started",
"sync_enabled": true,
"auto_create_issues": false
}
Configure sync settings
Choose which events trigger syncs between ProductBridge and Linear.
| Event | Direction | Description |
|---|---|---|
| Issue created | Linear → ProductBridge | Creates a linked doc task |
| Doc published | ProductBridge → Linear | Moves the linked issue to Done |
| Status changed | Linear → ProductBridge | Updates the doc task status |
| Comment added | Bidirectional | Syncs comments between platforms |
Linking docs to Linear issues
Link documentation pages to Linear issues for full traceability between your docs and development work.
Open a documentation page and click Link Issue in the sidebar.
Search by issue identifier (e.g., DOC-42) or title.
Linked: DOC-42 — Write onboarding guide
Status: In Progress
Assignee: Alex
Priority: High
Install the ProductBridge integration from the Linear settings page.
In any issue, use the ProductBridge attachment to link or create a doc page directly.
Automations
Set up automations to reduce manual work when managing docs alongside Linear issues.
{
"trigger": "doc.published",
"action": "linear.create_issue",
"config": {
"team": "Documentation",
"title": "Review: {doc_title}",
"label": "review",
"priority": 2
}
}
{
"trigger": "linear.issue.completed",
"action": "doc.update_status",
"config": {
"set_status": "reviewed",
"add_label": "approved"
}
}
Webhook events
ProductBridge sends webhook payloads for Linear-related events.
Last updated today
Built with Documentation.AI