Linear Integration

Connect Dunmore to Linear to automatically create issues when payments fail. Your engineering team can track, prioritize, and resolve payment problems directly in Linear.

Setup

1. Create a Linear API key at Settings > API > Personal API keys
2. Find your Team ID from the team's settings page URL or via the Linear API
3. Add a Linear connector in the Dunmore console or via the API

Supported Events

Dunmore Event	Linear Action	Priority
payment.failed	Creates an issue with payment failure details	Urgent (P1)

Only payment.failed events create Linear issues. Other event types are ignored.

Issues include:

• Title: Payment failed: $X.XX USDC on /endpoint
• Description: Amount, payer wallet, endpoint, failure stage, error code, error message, and event ID

Configuration

{
  "type": "linear",
  "config": {
    "apiKey": "lin_api_xxxxxxxxxxxx",
    "teamId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
  },
  "eventTypes": ["payment.failed"]
}

Field	Required	Description
apiKey	Yes	Linear personal API key
teamId	Yes	Linear team ID to create issues in

API Example

curl -X POST https://api.dunmore.xyz/api/projects/{projectId}/connectors \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "linear",
    "config": {
      "apiKey": "lin_api_xxxxxxxxxxxx",
      "teamId": "YOUR_TEAM_ID"
    },
    "eventTypes": ["payment.failed"]
  }'