Jellyfish and linear

Setup Your Jellyfish –
Linear Integration

Jellyfish + LinearConnect your Linear workspace to Jellyfish to automatically sync issue, project, and comment events. This integration uses webhooks to keep Jellyfish updated in real time as your teams create, update, and complete work in Linear.

How to setup the Linear integration

Prerequisites

Jellyfish access: Admin user role
Linear access: Admin role

In Jellyfish

  1. Navigate to Settings → System Settings → System Setup → Integrations.
  2. Click the Instructions button on the Linear Integration card.
  3. In the Configure a Webhook in Linear dialog, reveal and copy the webhook URL that Linear will send events to. Keep this tab open; you’ll return to it shortly.

In Linear

  1. In a new tab, log in to Linear and navigate to Settings → Administration → API.
  2. Under Webhooks, click the + button to create a new webhook.
  3. In the Create Webhook dialog: Enter Jellyfish Webhooks in the Label field.
  4. Paste the webhook URL you copied from Jellyfish into the URL field.
  5. Select all Data change events. (Jellyfish automatically ignores any events it doesn’t require.)
  6. Copy the generated Signing Secret and store it securely.
  7. Click Create Webhook.

Back in Jellyfish

  1. In the Configure a Webhook in Linear dialog, paste the Signing Secret generated by Linear.
  2. Click Save Secret.

What the Linear data powers

Jellyfish uses the data collected from Linear to: Calculate engineering metrics like lead time and cycle time Track the status of issues and projects Power investment categories, DevFinOps, delivery, and other parts of the platform