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#
- Go to Linear → Settings → API → Personal API keys.
- Click Create key. Give it a label like "Elido integration".
- Copy the key. Linear only shows it once.
Configure in Elido#
- Go to Dashboard → Integrations → Linear → Configure.
- Paste the API key.
- Click Fetch teams. Elido calls the Linear API and lists every team your key has access to.
- Select the target team. Issues will be created there.
- (Optional) Set a default assignee and a label. Both are passed through to the Linear issue.
- 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.