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

Description: Connect Jira Cloud to trigger workflows from issue and comment events, and call Jira tools from workflows.

## Authentication [#authentication]

Shipfox uses Jira OAuth authorization. The flow requests
`read:jira-work`, `write:jira-work`, `read:jira-user`, `manage:jira-webhook`, and
`offline_access`.

## Integration connection identity [#integration-connection-identity]

The slug of a Jira integration connection defaults to `jira_<site>`, where
`<site>` is the normalized Jira site name. For example, `jira_acme`. If the site
name is unavailable, Shipfox uses the Jira cloud ID. Shipfox makes the slug
unique within the workspace.

Use the slug as `source` for Jira events:

```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).

## Capabilities [#capabilities]

| Capability | Details                                        |
| ---------- | ---------------------------------------------- |
| Events     | [View Jira events](https://www.shipfox.io/docs/integrations/jira/events). |
| Tools      | [View Jira tools](https://www.shipfox.io/docs/integrations/jira/tools).   |

[Connect Jira](https://www.shipfox.io/docs/integrations/jira/setup) to create an integration connection.