Overview

Linear is an issue tracking and project management tool built for software teams to plan sprints, triage bugs, and coordinate engineering work across projects and cycles. Persona's Linear integration enables automated issue management directly from your workflows — creating and updating Linear issues when identity events require engineering attention, without manual handoff between operations and engineering teams.

Benefits

Bridge Operations and Engineering: Automatically create Linear issues when Persona detects a fraud pattern, an integration failure, or a workflow error — so engineering teams are alerted and can act without waiting for a manual ticket.

Keep the Backlog in Sync: Update issue state, title, description, priority, and assignee from Persona workflows so your Linear board reflects the current status of identity-related work.

Prioritize by Signal Severity: Set issue priority (urgent, high, medium, low) based on the severity of the Persona event, ensuring your engineering team focuses on what matters most.

Reduce Context Switching: Engineers using Linear as their primary planning tool can receive and manage identity-related work items directly in their existing workflow.

Improve Response Time: Automated issue creation is faster than manual ticket filing — reducing the time between an identity signal and engineering response.

Integration Features

Persona's Linear integration enables automation across issue management workflows. Key capabilities include:

• List Teams: Return teams in your Linear workspace for dynamic team ID lookup.
• List Issues: Return issues across the workspace with state, assignee, and priority details.
• Create Issue: Create new issues with title, description, team, priority, state, and assignee.
• Update Issue: Update existing issues' title, description, state, assignee, or priority.

Setting up the Linear integration

Prerequisites

To set up the Linear integration, ensure you have:

• A Linear account with member or admin access
• A Linear API key (generated in Settings > API > Personal API keys)

Setting up the Linear credentials

1. In the Persona Dashboard, navigate to Integrations > Marketplace and click on Linear.
2. Click on Add Credential at the top of the page.
3. Enter a Nickname for Credential in the modal, along with your Linear API key, and click Continue.
4. Once complete, the credential will appear in Persona and can be selected in workflows.

Using the Linear integration in a workflow

1. Create a new workflow, or open an existing workflow you'd like to update.
2. Add a new action step > Integrations.
3. Select the Linear integration and choose your Linear credential.
4. Select the operation you want to run and map Persona data into the input fields.
5. Save and publish the workflow.

Linear Operations Overview

Persona supports multiple Linear API operations for managing issues within your engineering workspace. These actions allow you to automate issue creation and updates, ensuring your engineering team is alerted and organized based on Persona identity events.

See below for a comprehensive list of available Workflow Action steps and possible configurations for the Linear integration:

List Teams

Return a paginated list of teams in your Linear workspace with team IDs needed for issue creation.

Configuration Steps:

• No required fields.
• Optionally add:
  • Page cursor
  • Page size

List Issues

Return a paginated list of issues across the workspace, including state, assignee, priority, and team details.

Configuration Steps:

• No required fields.
• Optionally add:
  • Page cursor
  • Page size

Create Issue

Create a new Linear issue in a specified team with title, description, priority, state, and assignee.

Configuration Steps:

• Provide values for required fields:
  • Title
  • Team ID
• Optionally add:
  • Description (supports Markdown)
  • Priority (0 = no priority, 1 = urgent, 2 = high, 3 = medium, 4 = low)
  • State ID
  • Assignee ID

Update Issue

Update an existing issue's fields by issue ID.

Configuration Steps:

• Provide values for required fields:
  • Issue ID
• Optionally add:
  • Title
  • Description
  • Priority
  • State ID
  • Assignee ID

FAQs

How do I find my Team ID?

Use the List Teams action to retrieve team IDs dynamically, or copy the team ID from your Linear workspace URL.

Can I close an issue from Persona?

Yes. Use Update Issue and set the State ID to your team's completed or canceled state ID (retrieve it from Linear's API or settings).