View as Markdown
Linear (API key) icon

Linear (API key) ACTION

Create Issue

Creates a new issue in Linear. Requires a team ID and title; all other fields are optional. Use Get Teams to discover valid team IDs, List Workflow States to find state IDs, List Users to find assignee IDs, and List Labels to find label IDs. Example: teamId: "9d1c3f7e-2b48-4c6a-9f1e-5a7b8c9d0e1f", title: "Fix login redirect on mobile" → returns {success: true, issue: {id: "iss_01", identifier: "ENG-42", title: "Fix login redirect on mobile"}}. See the documentation.
  • Action
  • Writes data
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Linear (API key) account once, then configure and run Create Issue from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "linear_app-create-issue",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    linear_app: { authProvisionId: "apn_xxxxxxx" },
    teamId: "Team",
    projectId: "Project",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Create Issue inputs
Property Type Description
teamId Team string
The team's id as returned by the Linear API — a UUID such as 9d1c3f7e-2b48-4c6a-9f1e-5a7b8c9d0e1f. The short team key shown in issue identifiers such as ENG-123 is rejected. Use Get Teams to discover valid team IDs.
Required
projectId Project string
The UUID of the project (e.g. a1b2c3d4-0000-0000-0000-000000000001). Use List Projects to find valid project IDs.
Optional
title Title string
The title of the issue.
Required
description Description string
The issue description in markdown format
Optional
assigneeId Assignee string
The UUID of the user to assign (e.g. abc12345-0000-0000-0000-000000000001). Use List Users to discover valid user IDs.
Optional
stateId State (Status) string
The UUID of the workflow state (status) to assign to the issue (e.g. 6758492b-ae98-454c-b944-eed5ade57d09). Use List Workflow States to find valid state IDs.
Optional
labelIds Label IDs string[]
The UUIDs of the labels to apply to the issue (e.g. ["ab1b2c3d-0000-0000-0000-000000000005"]). Use List Labels to find valid label IDs.
Optional
priority Priority integer
The priority of the issue
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
linear_app-create-issue
Version
0.4.22
App
Linear (API key)
Authentication
API key
Read-only
No
Destructive
No
Open world
Yes