# Linear events (https://www.shipfox.io/docs/integrations/linear/events)

Description: See which Linear events can start a workflow and what each event contains.

## Event catalog [#event-catalog]

Use your Linear integration connection slug instead of `linear_acme`.

### Issues

Changes to a Linear issue. The event includes the type, the action, and the issue itself under data.

**Payload:** Fields from Linear. [Linear docs](https://linear.app/developers/webhooks)

#### `Issue.create`

A Linear issue is created.

```yaml
triggers:
  on_issue_create:
    source: linear_acme
    event: Issue.create
```

#### `Issue.update`

A Linear issue changes.

```yaml
triggers:
  on_issue_update:
    source: linear_acme
    event: Issue.update
```

#### `Issue.remove`

A Linear issue is removed.

```yaml
triggers:
  on_issue_remove:
    source: linear_acme
    event: Issue.remove
```

### Comments

Changes to a Linear comment. The event includes the type, the action, and the comment itself under data.

**Payload:** Fields from Linear. [Linear docs](https://linear.app/developers/webhooks)

#### `Comment.create`

A Linear comment is created.

```yaml
triggers:
  on_comment_create:
    source: linear_acme
    event: Comment.create
```

#### `Comment.update`

A Linear comment changes.

```yaml
triggers:
  on_comment_update:
    source: linear_acme
    event: Comment.update
```

#### `Comment.remove`

A Linear comment is removed.

```yaml
triggers:
  on_comment_remove:
    source: linear_acme
    event: Comment.remove
```

### Issue labels

Changes to a Linear issue label. The event includes the type, the action, and the issue label itself under data.

**Payload:** Fields from Linear. [Linear docs](https://linear.app/developers/webhooks)

#### `IssueLabel.create`

A Linear issue label is created.

```yaml
triggers:
  on_issue_label_create:
    source: linear_acme
    event: IssueLabel.create
```

#### `IssueLabel.update`

A Linear issue label changes.

```yaml
triggers:
  on_issue_label_update:
    source: linear_acme
    event: IssueLabel.update
```

#### `IssueLabel.remove`

A Linear issue label is removed.

```yaml
triggers:
  on_issue_label_remove:
    source: linear_acme
    event: IssueLabel.remove
```

### Projects

Changes to a Linear project. The event includes the type, the action, and the project itself under data.

**Payload:** Fields from Linear. [Linear docs](https://linear.app/developers/webhooks)

#### `Project.create`

A Linear project is created.

```yaml
triggers:
  on_project_create:
    source: linear_acme
    event: Project.create
```

#### `Project.update`

A Linear project changes.

```yaml
triggers:
  on_project_update:
    source: linear_acme
    event: Project.update
```

#### `Project.remove`

A Linear project is removed.

```yaml
triggers:
  on_project_remove:
    source: linear_acme
    event: Project.remove
```

### Cycles

Changes to a Linear cycle. The event includes the type, the action, and the cycle itself under data.

**Payload:** Fields from Linear. [Linear docs](https://linear.app/developers/webhooks)

#### `Cycle.create`

A Linear cycle is created.

```yaml
triggers:
  on_cycle_create:
    source: linear_acme
    event: Cycle.create
```

#### `Cycle.update`

A Linear cycle changes.

```yaml
triggers:
  on_cycle_update:
    source: linear_acme
    event: Cycle.update
```

#### `Cycle.remove`

A Linear cycle is removed.

```yaml
triggers:
  on_cycle_remove:
    source: linear_acme
    event: Cycle.remove
```

### Agent sessions

Requests from Linear to the connected agent. The event includes the session and the prompt.

**Payload:** Fields from Linear. [Linear docs](https://linear.app/developers/agent-interaction)

#### `agentSession.created`

A Linear agent session is created.

```yaml
triggers:
  on_agent_session_created:
    source: linear_acme
    event: agentSession.created
```

#### `agentSession.prompted`

A user adds a prompt to a Linear agent session.

```yaml
triggers:
  on_agent_session_prompted:
    source: linear_acme
    event: agentSession.prompted
```