View as Markdown
Linear (API key) icon

Linear (API key) ACTION

Create Project

Create a new project in Linear to track a body of work. Projects group related issues within a team. Use Get Teams for team IDs, List Project Statuses to find status IDs, List Users for member IDs, and List Project Labels for label IDs. Example: teamId: "9d1c3f7e-...", projectName: "Mobile App v2", statusId: "s2abc" → returns {success: true, project: {id: "proj_01", name: "Mobile App v2"}}. 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 Project 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-project",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    linear_app: { authProvisionId: "apn_xxxxxxx" },
    teamId: "Team",
    projectName: "Name",
  },
})

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 Project 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
projectName Name string
The name of the project. Example: Mobile App v2.
Required
description Description string
The description of the project
Optional
statusId Status ID string
The UUID of the project status (e.g. 5a1b2c3d-0000-0000-0000-000000000006). Use List Project Statuses to find valid status IDs.
Optional
priority Priority integer
The priority of the project
Optional
memberIds Member IDs string[]
The IDs of the members of the project
Optional
startDate Start Date string
The start date of the project in ISO 8601 format
Optional
targetDate Target Date string
The target date of the project in ISO 8601 format
Optional
labelIds Label IDs string[]
The UUIDs of the project labels to apply (e.g. ["9a1b2c3d-0000-0000-0000-000000000007"]). Use List Project Labels to find valid label IDs.
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-project
Version
1.0.0
App
Linear (API key)
Authentication
API key
Read-only
No
Destructive
No
Open world
Yes