Jira Server Setup

  1. Adding Halp IP addresses to your Amazon Jira DC Stack security group (This is only applicable if you restrict access to your Jira instance)

Go to your security group settings in AWS, find your JiraDCStack group, and add the following IP addresses in CIDR notation:


All incoming API requests from Halp will come from one of these two IP addresses.


  1. Add a Halp user to Jira and configure permissions

First, create a user for Halp to connect to Jira with. We recommend naming it in a way that makes it clear it’s not a normal user, for example “Halp Bot”.

Then, make sure the user is in the group “jira-servicedesk-users”.

Next, add the user to a project you want to sync Halp with and ensure that it is a member of the “Service Desk Team” role:

Open administration settings and navigate to “Application links”.

Then, enter halp.com as the domain, press continue to ignore this warning:

On the next page, enter the following values:

The “na” is for “not applicable”, and you can enter it for all these parameters as our application does not make use of an outgoing link. However, ensure you check “Create incoming link”.

You should see this page:

Enter these values:

Consumer Key: halp-consumer-5z5HK4Eb

Consumer Name: Halp

Public Key:



Hit continue, and you should see the following:

  1. Set up a comment webhook.

From the Jira settings console, navigate to System > WebHooks. 

Click “Create a webhook”, and you should see the following:

Enter the following values:

Name: Halp webhook

Status: Enabled

URL: https://your-halp-subdomain.halp.com/integrations/jiraserver/comment-webhook

Leave events for “All issues” and check the boxes under “Comment” labeled “created”, “updated”, and “deleted”, as well as under Issue for "created", "updated", and "deleted."


  1. Authenticating Jira to Halp

    1. OAuth Instructions

*****Log out of your personal Jira user, and log in using your Halp Bot user.*****

Then log into Halp, go to Settings > Integrations, and add a new Jira Server integration from the dropdown.

Enter your Jira URL with the protocol but without a trailing slash, and hit authenticate.

    1. Basic Auth Instructions

      Click 'Basic Auth' radial button and complete Username & Password form

  1. Set up a Halp Recipe to route tickets.

On this page, click “Allow”.

You should see this, which means Jira server is ready to configure just like any other integration!

Known Issues

  • If your Jira Server instance sits behind a proxy, you might need additional configuration to enable features like sending Jira tickets to Halp. Please contact support@halp.com for more information.

How did we do?

Powered by HelpDocs (opens in a new tab)