Skip to main content

​
What the Jira integration enables

CapabilityDescription
Automation workflowsStreamline issue creation, status updates, project management tasks, and user access management
Ticket SyncingSync tickets between Serval and Jira
Anything defined in the Jira REST API 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 Jira OAuth Connect
  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, you need to install the Serval app in your Jira instance and configure the sync settings.
You must first connect your Jira instance to Serval using the OAuth flow described in the Serval Configuration section above before proceeding with ticket syncing setup.

​
Step 1: Install the Serval App

1

Install the Serval App

Turn on Ticket Syncing from the Jira app in Serval.Turn on Ticket Syncing
2

Open the Atlassian app installation page

Go to the Serval app installation page on the Atlassian Developer Console.Atlassian App Installation Page
3

Complete the installation

Follow the instructions on the Atlassian page to install the Serval app on your Jira instance.
4

Verify the installation

Return to Serval and refresh the page to see the updated installation status.
It may take up to 5 minutes for the installation to take effect. This delay is on Jira’s end.

​
Step 2-6: Configure Sync Settings

Once the app is installed, complete the remaining configuration steps in Serval:
  1. Select Project - Choose the Jira project to sync tickets with
  2. Select Request Type - Choose the request type for creating tickets in Jira
  3. Priority Mapping - Map each Jira priority to a Serval priority option
  4. Status Mapping - Map each Jira status to a Serval status option
  5. Sync Strategy - Configure how and when tickets should be synced
Serval Ticket Syncing Configuration Steps
Need help? Contact [email protected] for assistance with your Jira integration.