# Jira events (https://www.shipfox.io/docs/integrations/jira/events)

Description: Look up the Jira event names Shipfox delivers and the payload fields exposed to workflows.

This reference lists Jira issue and comment events that Shipfox delivers to a
Jira integration connection. See the [Jira overview](https://www.shipfox.io/docs/integrations/jira) for
authentication and setup.

## Payload [#payload]

The `event` value contains the validated Jira webhook envelope plus `cloudId`,
which identifies the connected Jira site. Jira-specific fields remain provider
owned.

| Field               | Description                                               |
| ------------------- | --------------------------------------------------------- |
| `webhookEvent`      | The Jira webhook event name.                              |
| `timestamp`         | The event timestamp supplied by Jira.                     |
| `issue`             | The Jira issue object, including its ID, key, and fields. |
| `user`              | The Jira user associated with the event.                  |
| `matchedWebhookIds` | Optional IDs of the Jira webhooks that matched the event. |
| `cloudId`           | The connected Jira site's cloud ID, added by Shipfox.     |

Issue events also include `issue_event_type_name` and may include `changelog`.
Comment events include a `comment` object. See the
[Jira webhook documentation](https://developer.atlassian.com/cloud/jira/platform/webhooks/)
for provider-specific field details.

Shipfox delivers events authored by the account that authorized the integration
connection. A workflow that writes back to Jira can trigger another run from its own change.

## Trigger fragment [#trigger-fragment]

Replace `jira_acme` with the slug of your Jira integration connection:

```yaml
triggers:
  on_jira:
    source: jira_acme
    event: jira:issue_updated
```

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

## Event catalog [#event-catalog]

### `jira:issue_created`

A Jira issue is created.

**Emitted when:** Jira sends an issue-created webhook.

**Payload:** Shipfox-normalized payload.

### `jira:issue_updated`

A Jira issue changes.

**Emitted when:** Jira sends an issue-updated webhook.

**Payload:** Shipfox-normalized payload.

### `jira:issue_deleted`

A Jira issue is deleted.

**Emitted when:** Jira sends an issue-deleted webhook.

**Payload:** Shipfox-normalized payload.

### `comment_created`

A comment is added to a Jira issue.

**Emitted when:** Jira sends a comment-created webhook.

**Payload:** Shipfox-normalized payload.

### `comment_updated`

A comment on a Jira issue changes.

**Emitted when:** Jira sends a comment-updated webhook.

**Payload:** Shipfox-normalized payload.

### `comment_deleted`

A comment is deleted from a Jira issue.

**Emitted when:** Jira sends a comment-deleted webhook.

**Payload:** Shipfox-normalized payload.