Help center      Automations & Integrations  
Jira + Process Street Integration

Jira + Process Street Integration

Updated March 7, 2024

Jira helps teams plan, assign, track, report, and manage their work together in teams or in cross-departments. You can integrate Jira with Process Street to make your workflows super powerful and automate your work via Webhooks or Zapier.

Connect Jira with Process Street via Webhook

A Webhook integration can bring information from Jira that would trigger a new workflow run in your Process Street account. Webhooks are automated messages or payloads sent from apps as a trigger to cause an action in a receiving app.

In this example, we will create a Webhook that runs the Customer Support Tickets workflow when a new issue is created in Jira.

Process overview:

  • We will create a Customer Support Tickets workflow in Process Street
  • We will create a few issues in our Jira organization. When a new issue is created, this will act as our trigger
  • We will create a webhook that listens for our desired trigger in Jira and runs the Customer Support Tickets workflow in Process Street

Now, let’s jump into the integration.

1. Preparations in Process Street

First, create a Workflow in Process Street and ensure to add form fields that are relevant to the data fields in Jira. This will help you to map the relevant information from Jira to Process Street.

This information is stored in Jira when an issue is created. So, we need to create relevant form fields in our workflow to push that information through to Process Street. For our example, these form fields should include the issue ID (number field), issue summary, user who created the issue (short text fields), issue description (long text field), and so on.

This will mean that whoever is working on the support ticket won’t have to look up information in Jira, but can instead see all the details in Process Street.

2. Preparations in Jira

Log into your Jira account or create a new account. Since we want to trigger a new run in Process Street when a new issue is created, we will be working in our project dashboard in Jira. If you don’t have any project yet, you can start by creating that first.

To create a new issue, click Create in the top centre of your screen and add the details like issue summary, description, tags, and other details you may want.

Note: You want to ensure that the form fields you have in your workflow match the fields you have in Jira. If you’d like to add more details to your Jira ticket, you can click on any existing issue and configure the issue type.

3. Create a Webhook trigger to run your workflow in Process Street

To get the webhook URL from Process Street, when you’re editing your workflow, click the + icon above your task list on the left. Here, you can look for Jira as a Trigger to Run this workflow.

You can name your webhook as the app name or any phrase that helps you identify the Trigger. Then copy your Webhook URL and select your event as Default.

4. Set up the Webhook Trigger in Jira

Click on the settings Cog in the top left corner and go to the System.

Then click on Webhooks under Advanced Settings in the left panel. Then click + Create webhook and fill in all the fields as shown below.

Note: Since Process Street needs to receive the JSON body, ensure to leave the “Exclude body” box unchecked.

If you’re looking for more help on how to set up your webhook in Jira, you can refer to their help doc here.

5. Finish the setup in Process Street

Now come back to Process Street and test your trigger. Your payload should return as a success but if it doesn’t, you might want to go back to Jira and create a new issue.

When your test returns successful, you can proceed to map your fields from your issue’s properties to your Process Street form fields.

Lastly, turn your webhook On and Save it. Then Publish your workflow and you’re all set!

As an extra step, you can go to Jira, create a new issue then come back to Process Street in the Reports Dashboard to confirm a new workflow is run.

Lastly, turn your webhook On and Save it. Then Publish your workflow and you’re all set!

As an extra step, you can go to Jira, update a deal stage to Closed Won then come back to Process Street in the Reports Dashboard to confirm a new workflow is run.

Connect Jira to Process Street via Zapier

Zapier connects over 1,000 apps together. It’s an “if this, then that” tool, meaning that once a trigger has occurred, an action will then take place. This helps to save you time and effort by automating processes.

In this example, we will look at how Jira can be integrated with Process Street so that when a new company name is added to Jira, a new client onboarding workflow is run.

You can integrate Process Street with Jira, using Process Street’s Automations.

This integration allows you to create an issue in Jira automatically, when a task is checked, or when a workflow run is completed.

Users: In order to create or update Automations, you must be an Administrator or a Full Member with “edit” permissions.

Example use cases

  • You collect information about a technical issue from your support desk. When a specific task is completed, a bug ticket is raised for your engineering team to investigate, and a Jira issue number is attached back into your support workflow run
  • Your support team submit product feedback from customers through a workflow run and once complete, this sends a new issue to your product team to prioritize and then investigate

How to set up an automation with Jira

Before you get started you’ll need to have a few things set up in Jira Software, and in your Process Street workflow.

Preparations in Jira

  1. Create or login to your Jira account
  2. Create a project (or use an existing one)
  3. Consider which issue type you’re going to use (an epic, a task, a subtask etc.) to map details from Process Street into, and remember your choice for when you’re building your automation later

Preparations in Process Street

  1. Login to your Process Street account
  2. Create or open the workflow you’d like to use for your automation and start editing it
  3. Required: Add either a short or long text form field into a task that you will use later for mapping your Jira issue summary. Give it a name label so it is easy to identify when creating your automation later
  4. Optional: Add a snippet form field into a task that you can use later for mapping your Jira issue description (example shown above). Give it a name label so it is easy to identify when creating your automation later
  5. Optional: Add another short text form field where you can store your Jira ticket number or ID once it’s been created. Give it a name label so it is easy to identify when creating your automation later
  6. Save changes to your workflow

Now you’re ready to go ahead and start creating your automation!

Open your Process Street workflow

Head to your library and open up the workflow you’d like to create an automation for. When viewing the workflow you will see the “Automations” tab next to the workflow tab, as shown below.

Choose your trigger

Start by selecting the trigger for your automation from the left side of your screen. This will be the event that will cause the automation to start (like a starting pistol being fired to kick off a race).

For Jira you can choose from these two triggers:

  1. When a task is checked then
  2. When a workflow run is complete then

Click the + button on your chosen trigger to get started.

Let’s walk through examples for each of these triggers and their respective actions.

1. When a task is checked

Select “When a task is checked then” from the left side of your screen.

Choose a task

Start by selecting the task in your workflow that will act as your trigger.

Choose an app

Next, click the Jira icon and a small tick will appear to confirm your selection.

Choose an action

Select the action “create issue”.

Putting it all together, in this example, completing the task “Pass to engineering” in your customer support workflow run creates a Jira issue for the engineering team to investigate. It also adds a note of the Jira issue number back into the workflow run, so that you can refer back to it later.

Authentication

When you select your chosen action, a pop-up window will appear and you will be prompted to choose an Atlassian account to run your automation through.

If it’s the first time you are connecting to Jira via Process Street, a pop-up window will appear for you to be able to create a new authentication.

Note: You will need to disable pop-ups blockers to allow you to authorize an app.

When prompted for your Jira Site URL, use the full URL including the URL prefix, e.g. “https://[yourdomain].atlassian.net”.

If you already have an account connected, then you can continue with the one shown, or select another account to add.

Required: Configure Jira project and issue type

Choose which Jira project to create the issue in, and the issue type you would like to create. Remember the issue type you thought of earlier? This is where you’ll need to add it. Click “Next”.

Map summary and description fields

Required: Map the field from your workflow run, that you would like to pull into your Jira issue summary. This will be either a short text or a long text form field that you added to your workflow earlier.

Optional: Map the snippet form field from your workflow run, that you would like to pull into your Jira issue description.

Click “Next”.

Optional: Map data to update in Process Street

This allows you to push data like the Jira ID number or Jira Key, back into your workflow run for future reference.

Click “Add new mapping” to map more fields. When you’re done mapping fields, click “Finish”.

Activate this automation

Now you’re ready to turn on your automation. Use one of the toggle switches shown below, to switch it on.

Now every time your task is checked, an issue will be created in Jira, pre-filled with the data you have mapped from your Process Street workflow run. Your Jira ticket or ID number will also be mapped back into the same workflow run.

2. When a workflow run is complete

Choose your trigger

Select “When a workflow run is complete then” from the left side of your screen.

Choose an app

Next, click the Jira icon and a small tick will appear to confirm your selection.

Choose an action

Select the action “create issue

Putting all this together, in this example, completing a workflow run from your “Product feedback” process creates a task for the product department, who triage, prioritize and assign it to one of their team.

Authentication

When you select your chosen action, a pop-up window will appear and you will be prompted to choose an Atlassian account to run your automation through.

If it’s the first time you are connecting to Jira via Process Street, a pop-up window will appear for you to be able to create a new authentication.

Note: You will need to disable pop-ups blockers to allow you to authorize an app.

When prompted for your Jira Site URL, use the full URL including the URL prefix, e.g. “https://[yourdomain].atlassian.net”.

If you already have an account connected, then you can continue with the one shown, or select another account to add. Click “Next”.

Required: Configure Jira project and issue type

Choose which Jira project to create the issue in, and the issue type you would like to create. Remember the issue type you thought of earlier? This is where you’ll need to add it. Click “Next”.

Map summary and description fields

Required: Map the field from your workflow run, that you would like to pull into your Jira issue summary. This will be either a short text or a long text form field that you added to your workflow earlier.

Optional: Map the snippet form field from your workflow run, that you would like to pull into your Jira issue description.

Click “Finish”.

Activate this automation

Now you’re ready to turn on your automation. Use one of the toggle switches shown below, to switch it on.

Now every time you complete a workflow run from this workflow, an issue will be created in Jira in your chosen project, including a summary (and optional description) mapped across from your Process Street workflow run.

Advanced

If you’re looking to create a really robust integration with Jira, you can use a workflow run link that you create inside Salesforce’s custom links for each of your accounts. You run your workflow run, create an issue in Jira and then a Slack automation notifies your customer success team in their channel that a new issue has been created.


Edit an automation

To be able to edit the fields you have mapped in your automation, or change the triggers or actions, you first need to turn off your automation using one of the toggle switches.

Delete an automation

To remove an automation from a workflow, you can delete it, but first, you will need to ensure that it has been switched off. Turn the toggle switch to the “off” position and then click the trashcan icon in the top right of your view to delete the automation.

Limitations

There are no filters, delays, or formulas built into automations at the moment. To be able to utilize these types of functions, you might want to consider using a Zapier integration instead.

Request another app

If you would like to request that we add another app to our automations, you can do that from the help button in the bottom right corner of your screen. Click “Suggestions” and send us your request.

Troubleshooting

If your automation stopped running, isn’t working as expected, or is showing errors, there might be a few reasons for this. Please check the following:

  • Did you turn the automation on once you set it up? Each automation has a separate “on/off” toggle switch
  • Did you edit your workflow, change or delete a form field that you were mapping in your automation? If you did, then this may cause your automation to stop running
  • Did you edit your workflow but not save the changes? You need to have saved any edits to your workflow to have the latest version pull through to your automations
  • Each time your automation runs you will see a record of success or failure, in your run logs

Run logs

You can check your automation run logs to see how your automations are running, or check for errors. You will find the automation run logs in two places, on your workflow or on workflow runs.

In your workflow on the automations tab, select an existing automation from the left side of your screen (highlighted in blue below). At the bottom of your page, you will see a list of all of the automation runs for that workflow. If your automation hasn’t run yet, you’ll see something similar to the below.

In a workflow run, in the upper right-hand corner of your task list, you’ll see the lightning bolt icon. Click the icon to see the run logs for that particular workflow run.

If you have any errors, click the word “Error” to expand more information on why your automation didn’t run.

The lightning bolt icon will only show up on workflow runs that have automations configured on them. This is an automation’s idle state.

When an automation is running, you’ll see the bolt change to the icon.

Once the automation finishes running, you’ll see either for success or for failure. If it’s a failure, you can click on the X to see the run logs and then click on the “Error” log for more information.

If you have any questions about using Automations, please reach out to our Process Pros team.


 

Discover Process Street

Use Process Street to make your team processes fun, fast and faultless. We'll help you transform your team's static checklists into powerful interactive workflows!

Learn more about Process Street

YouTube videos
Deep dive into Process Street with our YouTube video series.
Join a webinar
Effectively record, replicate, and replace your workflow!
See latest releases
Catch up on the latest releases and enhancements.
Join the community
Share with others about how you are using the app day to day.

Take control of your workflows today.