View as Markdown
Linear (API key) icon

Linear (API key) ACTION

Create Issue

Creates a new issue in Linear. Requires team ID and title. Optional: description, assignee, project, state. Returns response object with success status and issue details. Uses API Key authentication. See the documentation.
  • Action
  • Writes data
  • Destructive
  • 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 associated with the issue. Select one from the list, or pass 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.
Required Dynamic
projectId Project string
The identifier or key of the project associated with the issue
Optional Dynamic
title Title string
The title of the issue.
Required
description Description string
The issue description in markdown format
Optional
assigneeId Assignee string
The user to assign to the issue
Optional Dynamic
stateId State (Status) string
The state (status) to assign to the issue
Optional Dynamic
labelIds Issue Labels string[]
The labels in the issue
Optional Dynamic
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.21
App
Linear (API key)
Authentication
API key
Read-only
No
Destructive
Yes
Open world
Yes