Linear

Signature Verification

Property	Value
Algorithm	HMAC-SHA256 (hex-encoded)
Header	Linear-Signature
Additional headers	Linear-Event, Linear-Delivery

Signing formula:

hex(HMAC-SHA256(raw_payload, secret))

Setup

1. In Linear, go to Settings > API > Webhooks
2. Add a new webhook with the URL:

   https://ingest.transyt.com/linear/{your-account-slug}

3. Copy the signing secret

Account Configuration

curl -X POST https://ingest.transyt.com/admin/accounts \
  -H "X-Admin-Token: YOUR_ADMIN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "linear",
    "account_slug": "main",
    "app_key": "my-app",
    "signing_secret_current": "your-linear-webhook-secret"
  }'

Event Type Mappings

Linear Resource	Transyt Event
Issue	issue.updated
IssueComment	comment.created
Project	project.updated
Cycle	cycle.updated
User	user.updated

External ID

The external ID is a composite of object_id:action:timestamp, ensuring each action on an object generates a unique event.