> ## 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] 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"}
>     ]
>   }
> }
> ```

### Use Project Filters

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.