> ## Documentation Index
> Fetch the complete documentation index at: https://docs.leen.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# JIRA ITSM

> Real-time data synchronization for JIRA Tickets using webhooks

## JIRA Webhooks

### Automatic Registration

JIRA webhooks can be automatically registered when you enable them in your connection options. Leen will:

1. Register a webhook with JIRA during connection initialization
2. Subscribe to issue events (create/update/delete)
3. Apply JQL filters based on your project filter settings
4. Events subscribed: `jira:issue_created`, `jira:issue_updated`, `jira:issue_deleted`

#### Enabling Automatic Webhooks

When creating or updating a JIRA connection, include `enable_webhooks: true` in your options:

```json theme={null}
{
  "vendor": "JIRA",
  "options": {
    "enable_webhooks": true,
  }
}
```

<Accordion title="Complete example with custom mappings">
  ```json theme={null}
  {
    "vendor": "JIRA",
    "options": {
      "enable_webhooks": true,
      "project_keys_filter": ["PROJ1", "ENG", "SEC"],
      "priority_mapping": [
        {"Highest": "CRITICAL"},
        {"High": "HIGH"},
        {"Medium": "MEDIUM"},
        {"Low": "LOW"},
        {"Lowest": "INFORMATIONAL"}
      ],
      "status_mapping": [
        {"To Do": "TODO"},
        {"In Progress": "IN_PROGRESS"},
        {"Done": "CLOSED"}
      ]
    }
  }
  ```
</Accordion>

### Use Project Filters

The optional filters for projects applied when creating connections, would also apply to the webhooks.