Elido
Help center

Integrations

Connect Linear to Elido

Auto-open Linear issues when a link hits a click threshold or a URL scan fails — API-token setup, team selection, no OAuth required.

Updated 2026-05-12

Coming Q3 2026. Sign up for early access at Dashboard → Integrations → Linear → Notify me. The setup below reflects the planned design.

The Linear integration opens issues automatically on specific Elido events. Useful for teams that track campaign failures and link-scan alerts as first-class work. Two events are supported: threshold exceeded (a link hits N clicks — often a signal to run more promotion or scale infra) and scan failure (a destination URL was flagged as malicious).

What you need#

  • A Linear account with permission to create issues in the target team.
  • A Linear personal API key (takes 30 seconds to generate).

Generate a Linear API key#

  1. Go to Linear → Settings → API → Personal API keys.
  2. Click Create key. Give it a label like "Elido integration".
  3. Copy the key. Linear only shows it once.

Configure in Elido#

  1. Go to Dashboard → Integrations → Linear → Configure.
  2. Paste the API key.
  3. Click Fetch teams. Elido calls the Linear API and lists every team your key has access to.
  4. Select the target team. Issues will be created there.
  5. (Optional) Set a default assignee and a label. Both are passed through to the Linear issue.
  6. Click Save.

Set up event triggers#

In Dashboard → Integrations → Linear → Triggers:

  • Threshold exceeded — Enter a click count. When any tracked link crosses it, Elido opens a Linear issue titled "Campaign milestone: [slug] hit [N] clicks". You can set different thresholds per link.
  • Scan failure — Toggle on. Each flagged link opens an issue titled "Investigate scan flag: [slug]" with the scanner's reason in the description.

What gets written to Linear#

Each auto-created issue includes:

  • Title as described above.
  • Description with the short URL, destination URL, and event details.
  • Direct link to the Elido analytics view for the link.
  • Assignee and label if you configured them.

Elido does not read back from Linear — it won't close issues or track issue state. That part is up to your team's workflow.

Troubleshooting#

"Not authorized" when fetching teams — The API key is wrong or has been revoked. Re-generate from Linear Settings → API.

Issues appearing in the wrong team — Verify the team selection in Dashboard → Integrations → Linear → Configure. If a key has access to multiple teams, the picker might have defaulted to the first one.

No issue created on threshold exceeded — Check that the link has a threshold set. The global trigger only fires for links where a per-link threshold is defined or the global default is active.

Duplicate issues — The threshold trigger fires once per crossing, not per click. If you're seeing duplicates, check that the same Linear workspace isn't connected under two Elido workspaces.

Was this helpful?
Need more? Email the team — replies within one working day.Contact support
Connect Linear to Elido · Elido