> ## Documentation Index
> Fetch the complete documentation index at: https://serval-hannah-docs-custom-access.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Jira

## What the Jira integration enables

| Capability           | Description                                                                                     |
| -------------------- | ----------------------------------------------------------------------------------------------- |
| Automation workflows | Streamline issue creation, status updates, project management tasks, and user access management |
| Ticket Syncing       | Sync tickets between Serval and Jira                                                            |

Anything defined in the [Jira REST API](https://developer.atlassian.com/cloud/jira/platform/rest/v3/intro/) can be accessed through Serval.

***

## Jira Configuration

Connecting Jira to Serval is straightforward and requires no manual configuration on the Jira side. The integration uses OAuth to securely connect your Jira instance with Serval.

### Prerequisites

* You must have admin permissions in your Jira instance
* Access to install apps in your Jira workspace

***

## Serval Configuration

1. In Serval go to **Apps → Available → Jira → Connect**

2. Click the **Connect** button to initiate the OAuth flow

3. A new window will open directing you to your Jira instance

   <img src="https://mintcdn.com/serval-hannah-docs-custom-access/fzMTcY0ZRf7ewJRV/images/integrations/jira/jira-oauth-connect.png?fit=max&auto=format&n=fzMTcY0ZRf7ewJRV&q=85&s=37508121b568aa78a49ed527b1762e1e" alt="Jira OAuth Connect" width="1599" height="1926" data-path="images/integrations/jira/jira-oauth-connect.png" />

4. Review and accept the integration permissions and scopes

5. Click **Accept** to complete the connection

6. You'll be redirected back to Serval with the integration successfully connected

That's it! No additional configuration is needed. Serval can now access your Jira instance through the authorized OAuth connection.

***

## Additional Notes

### Ticket Syncing

To enable ticket syncing follow these steps:

1. Navigate to `https://admin.atlassian.com/s/[your-instance-id]/user-connected-apps/tab/installed`

2. Click the **Settings** tab

3. Ensure **Enable development mode** is turned on

   <img src="https://mintcdn.com/serval-hannah-docs-custom-access/fzMTcY0ZRf7ewJRV/images/integrations/jira/jira-enable-dev-mode.png?fit=max&auto=format&n=fzMTcY0ZRf7ewJRV&q=85&s=25302fff3fd44ccf112b10aa4f05ab36" alt="Enable Developer Mode" width="1494" height="1186" data-path="images/integrations/jira/jira-enable-dev-mode.png" />

4. Click **Install private app** button

   <img src="https://mintcdn.com/serval-hannah-docs-custom-access/fzMTcY0ZRf7ewJRV/images/integrations/jira/jira-install-private-app-button.png?fit=max&auto=format&n=fzMTcY0ZRf7ewJRV&q=85&s=a3032ca4c15f4c7caac1406482ddf31d" alt="Install Private App Button" width="1316" height="332" data-path="images/integrations/jira/jira-install-private-app-button.png" />

5. Enter the following URL: `https://svflow-oauth.api.serval.com/jira-connect/atlassian-connect.json`

   <img src="https://mintcdn.com/serval-hannah-docs-custom-access/fzMTcY0ZRf7ewJRV/images/integrations/jira/jira-install-private-app-modal.png?fit=max&auto=format&n=fzMTcY0ZRf7ewJRV&q=85&s=2dfad53aa2aa9a3045854b631d9754a6" alt="Install Private App Modal" width="1316" height="794" data-path="images/integrations/jira/jira-install-private-app-modal.png" />

6. Click **Install** to enable enhanced ticket syncing features

***

Need help? Contact **[support@serval.com](mailto:support@serval.com)** for assistance with your Jira integration.