# New Issue Created (Instant) — Linear (API key)

> Triggers instantly when a new issue is created in Linear. Provides complete issue details including title, description, team, assignee, state, and timestamps. Supports filtering by team and project. See Linear docs for additional info here.

- Key: `linear_app-issue-created-instant`
- Type: Trigger (Instant)
- Version: 0.3.23
- App: Linear (API key) (`linear_app`) — https://pipedream.com/apps/linear-app.md
- This page (HTML): https://pipedream.com/apps/linear-app/triggers/issue-created-instant
- Source: https://github.com/PipedreamHQ/pipedream/blob/master/components/linear_app/sources/issue-created-instant/issue-created-instant.mjs

## Description

Triggers instantly when a new issue is created in Linear. Provides complete issue details including title, description, team, assignee, state, and timestamps. Supports filtering by team and project. See Linear docs for additional info [here](https://linear.app/developers/webhooks).

## Props

| Prop | Type | Required | Description |
|---|---|---|---|
| `teamIds` | `string[]` | Yes | 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. Options are loaded from the connected account. |
| `projectId` | `string` | No | The identifier or key of the project associated with the issue Options are loaded from the connected account. |
| `limit` | `integer` | No | Maximum number of items to return when polling. Defaults to 20 if not specified. |

## Returns

Events emitted by Linear (API key).

## Run it

**TypeScript**

```ts
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 deployed = await pd.triggers.deploy({
  id: "linear_app-issue-created-instant",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    linear_app: { authProvisionId: "apn_xxxxxxx" },
    teamIds: ["Team IDs"],
    projectId: "Project",
  },
  webhookUrl: "https://example.com/webhooks/linear-app",
})

console.log(deployed.id)
```

**cURL**

```bash
curl -X POST https://api.pipedream.com/v1/connect/{project_id}/triggers/deploy \
  -H "Content-Type: application/json" \
  -H "X-PD-Environment: production" \
  -H "Authorization: Bearer {access_token}" \
  -d '{
    "external_user_id": "{external_user_id}",
    "id": "linear_app-issue-created-instant",
    "webhook_url": "https://example.com/webhooks/linear-app",
    "configured_props": {
      "linear_app": { "authProvisionId": "apn_xxxxxxx" },
      "teamIds": ["Team IDs"],
      "projectId": "Project"
    }
  }'
```

**MCP**

MCP servers expose Linear (API key) actions as on-demand tools.

New Issue Created (Instant) is an event source, so your application deploys it with the Connect SDK or API and then either receives each event at a webhook URL or retrieves events on demand with the trigger events API.

## Event delivery

Every event is sent to the HTTP endpoint you choose when you deploy the source. Or: no webhook required — your app or agent can fetch recent events from the [trigger events API](https://pipedream.com/docs/connect/api-reference/list-trigger-events.md) instead.

---

- App: https://pipedream.com/apps/linear-app.md · All apps: https://pipedream.com/apps