TriggerLinearReal-timeUpdated June 2026

How do I trigger when a new Linear project is created?

Short answer: Drop the "Linear → New Project" trigger on your workflow canvas, add filters if you want them, and publish. It fires within seconds of the event in Linear, not on a polling schedule.

Use this trigger All 6 Linear triggers

Anatomy

What this trigger looks like in a workflow.

Drop it on the canvas. Configure a couple of fields. Publish.

In the builder

Trigger

New Project

When the matching event happens

project addednew project creatednew projectwhen project createdon project createdwatch for project createdwhen a new project is created in linear

What this trigger returns

for the curious

You don’t need to read this. Tiny Command auto-maps every field into the visual picker so downstream nodes can pull values by clicking. We show it here for power users who want to know what’s on the wire.

{
  "url": "https://linear.app/.../project/p-1",
  "name": "TC project",
  "type": "Project",
  "state": "planned",
  "action": "create",
  "lead_id": null,
  "actor_id": "user-id",
  "team_ids": [
    "team-id"
  ],
  "actor_name": "Test",
  "created_at": "2026-04-11T10:00:00.000Z",
  "creator_id": "user-id",
  "project_id": "p-1",
  "start_date": null,
  "updated_at": "2026-04-11T10:00:00.000Z",
  "actor_email": "t@x.com",
  "description": null,
  "occurred_at": "2026-04-11T10:00:00.000Z",
  "target_date": null,
  "organization_id": "org"
}

Output shape

Fields available to downstream nodes.

Every field below can be referenced by name in any action or filter that comes after this trigger.

Field	Type	Example
url	string	"https://linear.app/.../project/p-1"
name	string	"TC project"
type	string	"Project"
state	string	"planned"
action	string	"create"
lead_id	null	null
actor_id	string	"user-id"
team_ids	array	["team-id"]
actor_name	string	"Test"
created_at	string	"2026-04-11T10:00:00.000Z"
creator_id	string	"user-id"
project_id	string	"p-1"
start_date	null	null
updated_at	string	"2026-04-11T10:00:00.000Z"
actor_email	string	"t@x.com"
description	null	null
occurred_at	string	"2026-04-11T10:00:00.000Z"
target_date	null	null
organization_id	string	"org"

Pairs with

Drop these actions after New Project.

Add Labels to Message

Gmail · Email

Add Reaction

Slack · Communication

Add Sheet Tab

Google Sheets · Spreadsheets & Databases

Create Company

HubSpot · CRM & Sales

FAQ

Questions about New Project.

How does the New Project trigger work in Linear?

Fires when a new project is created in Linear. Use to provision related docs, mirror to a roadmap tool, or notify product.

Is the New Project trigger real-time?

Yes. New Project uses webhooks or push subscriptions, not polling. Your workflow fires within seconds of the event happening in Linear.

What data does New Project return?

The full event payload from Linear. The output shape table on this page lists every field, its type, and an example value so you can map fields into downstream nodes.

Can I filter New Project so only some events start a workflow?

Yes. Add a Filter node right after the trigger and match on any field, whether that's subject, sender, status, or anything else in the payload. Workflows only continue when the filter passes.

Do I need Linear admin permissions to use New Project?

For most Linear accounts a standard user can authorize the trigger. Some Linear plans require an admin to enable third-party webhooks. Check Linear's docs if the trigger fails to register.