Linear Ticket Create Block

Create tickets in Linear using Scout workflows

The Linear Ticket Create block allows users to automate the creation of issues in Linear directly from Scout workflows. This block utilizes the Linear API to generate tickets with specified details such as title, description, team, project, and assignee. It supports dynamic content through Jinja templating, allowing for flexible and customizable ticket creation.

Configuration

Title
stringRequired

Title of the Linear issue. This field is required and should provide a concise summary of the issue.

Description
codeRequired

Detailed description of the issue. This field supports Jinja templating, allowing for dynamic content generation based on the workflow state.

Team ID
codeRequired

ID of the team. This field supports Jinja templating for dynamic team assignment.

Project ID
code

ID of the project. This field supports Jinja templating and defaults to an empty string if not specified.

Assignee ID
code

ID of the assignee. This field supports Jinja templating and defaults to an empty string if not specified.

API Key
stringRequired

API key for Linear API. Ensure that the API key provided has the necessary permissions to create issues in Linear.

See Workflow Logic & State > State Management for details on using dynamic variables in this block.

Outputs

The block returns the details of the created Linear issue, including its ID, title, and identifier. This output can be used in subsequent workflow steps to facilitate further processing or integration.

Usage Context

Use this block to automate the creation of issues in Linear from within a Scout workflow. This is particularly useful for integrating issue tracking with automated processes and ensuring consistent ticket creation.

Best Practices

  • Ensure that the API key provided has the necessary permissions to create issues in Linear.
  • Use Jinja templating for dynamic content in the description, team ID, project ID, and assignee ID fields to adapt to different workflow states.
  • Validate that the team ID, project ID, and assignee ID correspond to existing entities in Linear to avoid errors.
Built with