Linear
App · Project Management · 6 actions · 1 trigger
Create and manage Linear issues with a personal API key.
Triggers
Start a workflow when something happens in Linear. See how triggers work.
Linear New Issue
Triggers when a new issue is created in a Linear team.
Filters
Narrow which events start a run.
team_idRequired
Event fields
What a run starts with. Later steps read each field with an @ reference.
issue_idtextidentifiertexttitletextstateobject
Actions
| Action | What it does |
|---|---|
| Add a comment to a Linear issue | Post a comment on a Linear issue thread. |
| Create a Linear issue | Create a new Linear issue with optional project, description, priority, and assignee. |
| Get Linear issue details | Retrieve detailed information for a Linear issue. |
| List Linear issues for a team | Fetch the latest Linear issues for a specific team. |
| List Linear teams | Fetch available Linear teams for the connected workspace. |
| Update Linear issue state | Move a Linear issue to a different workflow state, such as Todo or Done, using the new state's ID. |
Add a comment to a Linear issue
Post a comment on a Linear issue thread.
Inputs
- Issue ID
issue_idtextRequired - Linear issue ID to comment on
- Comment
bodytextRequired - The comment text to post
Outputs
commentobject- Comment details
Example output
{
"comment": {
"body": "Sample text content",
"id": "abc123xyz789"
}
}Create a Linear issue
Create a new Linear issue with optional project, description, priority, and assignee.
Inputs
- Team ID
team_idtextRequired - Linear team ID for the issue
- Title
titletextRequired - Issue title
- Description
descriptiontext - Issue description. Markdown formatting is supported.
- Project ID
project_idtext - ID of the project to add the issue to
- Priority
prioritynumber - Priority level, from 1 to 5
- Assignee ID
assignee_idtext - ID of the user to assign the issue to
Outputs
issueobject- Issue details
Example output
{
"issue": {
"id": "abc123xyz789",
"identifier": "abc123xyz789",
"state": {
"id": "state123",
"name": "Todo",
"type": "unstarted"
},
"title": "Sample Item",
"url": "https://example.com/path/123"
}
}Get Linear issue details
Retrieve detailed information for a Linear issue.
Inputs
- Issue ID
issue_idtextRequired - Linear issue ID to fetch
Outputs
issueobject- Issue details
Example output
{
"issue": {
"description": "example_value",
"id": "abc123xyz789",
"identifier": "abc123xyz789",
"state": {
"id": "state123",
"name": "Active",
"type": "started"
},
"title": "Sample Item",
"url": "https://example.com/path/123"
}
}List Linear issues for a team
Fetch the latest Linear issues for a specific team.
Inputs
- Team ID
team_idtextRequired - Linear team ID to list issues for
- Maximum issues
firstnumber - Maximum number of issues to return (1-50)
Outputs
issueslist- Array of Linear issues for the specified team. Each issue contains id (UUID for actions), identifier (human-readable), title, and state. Use issue id with linear_update_issue_state or linear_add_comment actions
Example output
{
"issues": [
{
"id": "item123",
"name": "Sample Task"
}
]
}List Linear teams
Fetch available Linear teams for the connected workspace.
Inputs
None.
Outputs
teamslist- Array of Linear teams in the workspace. Each team contains id (use for creating/listing issues), name, and key (issue prefix). Use team id with linear_create_issue action
Example output
{
"teams": [
{
"id": "team123",
"key": "ENG",
"name": "Engineering"
}
]
}Update Linear issue state
Move a Linear issue to a different workflow state, such as Todo or Done, using the new state's ID.
Inputs
- Issue ID
issue_idtextRequired - Linear issue ID to update
- State ID
state_idtextRequired - ID of the workflow state to move the issue to
Outputs
issueobject- Issue details
Example output
{
"issue": {
"id": "abc123xyz789",
"identifier": "abc123xyz789",
"state": {
"id": "state123",
"name": "Active",
"type": "started"
},
"title": "Sample Item"
}
}