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

Description: Look up the Linear event names Shipfox delivers and the raw webhook payload available to workflows.

This reference lists Linear data and agent-session events that Shipfox delivers
to a Linear integration connection. See the
[Linear overview](https://www.shipfox.io/docs/integrations/linear) for authentication and setup.

## Payload [#payload]

Shipfox passes the raw Linear webhook body to a run as `event`. Linear owns the
payload schema and can add fields.

Data events include the resource `type`, the `action`, and the resource under
`data`. See the [Linear webhook reference](https://linear.app/developers/webhooks)
for the full payload.

Agent-session events include the session and prompt context supplied to the
connected app. See [Linear agent interaction](https://linear.app/developers/agent-interaction)
for those fields.

## Trigger fragment [#trigger-fragment]

Replace `linear_acme` with the slug of your Linear integration connection:

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

For trigger field rules, see the
[workflow schema reference](https://www.shipfox.io/docs/reference/workflow-schema#trigger-fields).

## Event catalog [#event-catalog]

### `Issue.create`

A Linear issue is created.

**Emitted when:** Linear sends a webhook for Issue with the create action.

**Payload:** Raw provider payload.

[Provider payload documentation](https://linear.app/developers/webhooks)

### `Issue.update`

A Linear issue changes.

**Emitted when:** Linear sends a webhook for Issue with the update action.

**Payload:** Raw provider payload.

[Provider payload documentation](https://linear.app/developers/webhooks)

### `Issue.remove`

A Linear issue is removed.

**Emitted when:** Linear sends a webhook for Issue with the remove action.

**Payload:** Raw provider payload.

[Provider payload documentation](https://linear.app/developers/webhooks)

### `Comment.create`

A Linear comment is created.

**Emitted when:** Linear sends a webhook for Comment with the create action.

**Payload:** Raw provider payload.

[Provider payload documentation](https://linear.app/developers/webhooks)

### `Comment.update`

A Linear comment changes.

**Emitted when:** Linear sends a webhook for Comment with the update action.

**Payload:** Raw provider payload.

[Provider payload documentation](https://linear.app/developers/webhooks)

### `Comment.remove`

A Linear comment is removed.

**Emitted when:** Linear sends a webhook for Comment with the remove action.

**Payload:** Raw provider payload.

[Provider payload documentation](https://linear.app/developers/webhooks)

### `IssueLabel.create`

A Linear issue label is created.

**Emitted when:** Linear sends a webhook for IssueLabel with the create action.

**Payload:** Raw provider payload.

[Provider payload documentation](https://linear.app/developers/webhooks)

### `IssueLabel.update`

A Linear issue label changes.

**Emitted when:** Linear sends a webhook for IssueLabel with the update action.

**Payload:** Raw provider payload.

[Provider payload documentation](https://linear.app/developers/webhooks)

### `IssueLabel.remove`

A Linear issue label is removed.

**Emitted when:** Linear sends a webhook for IssueLabel with the remove action.

**Payload:** Raw provider payload.

[Provider payload documentation](https://linear.app/developers/webhooks)

### `Project.create`

A Linear project is created.

**Emitted when:** Linear sends a webhook for Project with the create action.

**Payload:** Raw provider payload.

[Provider payload documentation](https://linear.app/developers/webhooks)

### `Project.update`

A Linear project changes.

**Emitted when:** Linear sends a webhook for Project with the update action.

**Payload:** Raw provider payload.

[Provider payload documentation](https://linear.app/developers/webhooks)

### `Project.remove`

A Linear project is removed.

**Emitted when:** Linear sends a webhook for Project with the remove action.

**Payload:** Raw provider payload.

[Provider payload documentation](https://linear.app/developers/webhooks)

### `Cycle.create`

A Linear cycle is created.

**Emitted when:** Linear sends a webhook for Cycle with the create action.

**Payload:** Raw provider payload.

[Provider payload documentation](https://linear.app/developers/webhooks)

### `Cycle.update`

A Linear cycle changes.

**Emitted when:** Linear sends a webhook for Cycle with the update action.

**Payload:** Raw provider payload.

[Provider payload documentation](https://linear.app/developers/webhooks)

### `Cycle.remove`

A Linear cycle is removed.

**Emitted when:** Linear sends a webhook for Cycle with the remove action.

**Payload:** Raw provider payload.

[Provider payload documentation](https://linear.app/developers/webhooks)

### `agentSession.created`

A Linear agent session is created.

**Emitted when:** Linear creates an agent session after a user mentions or delegates to the app.

**Payload:** Raw provider payload.

[Provider payload documentation](https://linear.app/developers/agent-interaction)

### `agentSession.prompted`

A user adds a prompt to a Linear agent session.

**Emitted when:** Linear sends an AgentSessionEvent webhook with the prompted action.

**Payload:** Raw provider payload.

[Provider payload documentation](https://linear.app/developers/agent-interaction)