You can for example create tickets in Jira and monitor their status using Journeys.

A common use case would be to create an issue for "new computer" as a part of an onboarding process.

You can see the API documentation from Jira here - to get ideas of what you can do in your integration.

In this example we're going to create a simple issue and check the status on it.

Let's start with the authentication.

Go to this link to create a token: https://id.atlassian.com/manage-profile/security/api-tokens

Copy the token you get:

Now create a new integration in Journeys, and add a basic authentication. Add your email and your API token as password:

Create a new endpoint, posting to an URL that is similar to this one: https://YOURJIRA.atlassian.net/rest/api/2/issue/ - but replace "YOURJIRA" with the name in your Jira space (when you are logged into Jira, you see the URL that you are on, and it says the name of your jira space).

This is the most basic way of creating a task, where we're only adding the project it should go into, the issue type, the name and description of the issue.

You probably want to add more, and then you can select from the Jira API documentation what else you want to add.

This is how you set it up:

Here is the JSON example request:

{

"fields": {

"project": {

"key": "KAN"

},

"summary": "A great summary",

"issuetype": {

"name": "Task"

},

"description": "Journeys Test"

}

}

You will of course need to use a "key" that is a project name in your Jira workspace, for example it could be "HR" or "IT" etc.

After you've saved this endpoint, you can test it and you should see a success response and an issue in your Jira workspace:

We do recommend creating a new list for the project keys and issue types, to be able to choose them from a dropdown list when adding Jira actions in your journeys and not need to type in "HR" etc.

You might want your Journey to wait for this Jira task to complete. In that case you need to make a new endpoint to get the status of this Jira task.

The URL of that endpoint should be: https://YOURCOMPANY.atlassian.net/rest/api/2/issue/{{issueIdOrKey}}?fields=status

Remember to replace "YOURCOMPANY" with your company name in Jira.

And you set it up like this:

Now when you test the request with any issue ID, you should get a response like this:

Note that in your response you will see something like this, depending on the status of the task:

These are the values we are interested in so you can delete all other values from the "Response values", so it should look like this:

Now, let's look at how you can use this in Journeys.

You start with creating the task:

Then you insert a "loop" to check regularly if the task is finished. By default the loop checks every 10 minutes.

Inside the loop you check the status of the task. You can see the "ID" there, which is retrieved from the action before (Create issue).

You then want to exit the loop, and continue the Journey, only if the status name is "Done"

Now you are ready to try it out yourself ! 🚀