Linear Integration

curl -X POST https://api.hookbase.app/api/sources \
  -H "Authorization: Bearer whr_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Linear Production",
    "slug": "linear",
    "provider": "linear",
    "signingSecret": "your-linear-signing-secret"
  }'

curl -X PATCH https://api.hookbase.app/api/sources/src_... \
  -H "Authorization: Bearer whr_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"signingSecret": "your-linear-signing-secret"}'

https://api.hookbase.app/ingest/{orgSlug}/linear

# Create destination for your issue handler
curl -X POST https://api.hookbase.app/api/destinations \
  -H "Authorization: Bearer whr_your_api_key" \
  -d '{"name": "Issue Tracker", "slug": "issue-tracker", "url": "https://api.myapp.com/webhooks/linear"}'
 
# Create route
curl -X POST https://api.hookbase.app/api/routes \
  -H "Authorization: Bearer whr_your_api_key" \
  -d '{"name": "Linear to Issue Tracker", "sourceId": "src_...", "destinationId": "dst_..."}'

{
  "provider": "linear",
  "signingSecret": "your-linear-signing-secret"
}

{
  "action": "create",
  "type": "Issue",
  "createdAt": "2026-03-07T12:00:00.000Z",
  "data": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "title": "Fix login redirect on mobile",
    "description": "Users on iOS Safari are not redirected after login.",
    "priority": 2,
    "priorityLabel": "High",
    "state": {
      "id": "state-id",
      "name": "Todo",
      "type": "unstarted"
    },
    "team": {
      "id": "team-id",
      "key": "ENG",
      "name": "Engineering"
    },
    "assignee": {
      "id": "user-id",
      "name": "Jane Smith",
      "email": "jane@example.com"
    },
    "labels": [
      { "id": "label-id", "name": "bug" }
    ],
    "number": 423,
    "identifier": "ENG-423",
    "url": "https://linear.app/myteam/issue/ENG-423"
  },
  "url": "https://linear.app/myteam/issue/ENG-423",
  "organizationId": "org-id"
}

{
  "action": "update",
  "type": "Issue",
  "createdAt": "2026-03-07T12:05:00.000Z",
  "data": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "title": "Fix login redirect on mobile",
    "priority": 1,
    "priorityLabel": "Urgent",
    "state": {
      "id": "state-id",
      "name": "In Progress",
      "type": "started"
    },
    "identifier": "ENG-423"
  },
  "updatedFrom": {
    "priority": 2,
    "priorityLabel": "High",
    "updatedAt": "2026-03-07T12:00:00.000Z"
  },
  "organizationId": "org-id"
}

{
  "action": "create",
  "type": "Comment",
  "createdAt": "2026-03-07T12:10:00.000Z",
  "data": {
    "id": "comment-id",
    "body": "Reproduced on iOS 17.3 Safari. Looks like the OAuth callback URL is missing the state parameter.",
    "issue": {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "identifier": "ENG-423",
      "title": "Fix login redirect on mobile"
    },
    "user": {
      "id": "user-id",
      "name": "Jane Smith"
    }
  },
  "organizationId": "org-id"
}

function transform(payload) {
  const issue = payload.data;
  const isUrgent = issue.priority <= 1;
 
  return {
    blocks: [
      {
        type: "header",
        text: {
          type: "plain_text",
          text: isUrgent ? "Urgent Issue Created" : "New Issue Created"
        }
      },
      {
        type: "section",
        fields: [
          {
            type: "mrkdwn",
            text: `*Issue:*\n<${issue.url}|${issue.identifier}: ${issue.title}>`
          },
          {
            type: "mrkdwn",
            text: `*Priority:*\n${issue.priorityLabel}`
          },
          {
            type: "mrkdwn",
            text: `*Team:*\n${issue.team.name}`
          },
          {
            type: "mrkdwn",
            text: `*Assignee:*\n${issue.assignee ? issue.assignee.name : 'Unassigned'}`
          }
        ]
      }
    ]
  };
}

function transform(payload) {
  const data = payload.data;
 
  return {
    linear_id: data.id,
    action: payload.action,
    resource_type: payload.type,
    identifier: data.identifier,
    title: data.title,
    priority: data.priority,
    state: data.state ? data.state.name : null,
    team_key: data.team ? data.team.key : null,
    assignee_email: data.assignee ? data.assignee.email : null,
    labels: data.labels ? data.labels.map(l => l.name) : [],
    url: data.url || payload.url,
    created_at: payload.createdAt
  };
}

{
  "name": "Issues Only",
  "logic": "AND",
  "conditions": [
    {
      "field": "type",
      "operator": "equals",
      "value": "Issue"
    }
  ]
}

{
  "name": "Urgent & High Priority",
  "logic": "AND",
  "conditions": [
    {
      "field": "type",
      "operator": "equals",
      "value": "Issue"
    },
    {
      "field": "data.priority",
      "operator": "less_than",
      "value": "3"
    }
  ]
}

{
  "name": "Completed Issues",
  "logic": "AND",
  "conditions": [
    {
      "field": "action",
      "operator": "equals",
      "value": "update"
    },
    {
      "field": "data.state.type",
      "operator": "equals",
      "value": "completed"
    }
  ]
}