---
canonical: https://amplience.com/developers/docs/workforce/flows/examples/webhook-trigger-example-jira/
title: JIRA webhook trigger
description: Learn to start Workforce Flows automatically. This example uses webhook triggered by an action performed in JIRA- such as created or editing an issue.
audience: Business User
image: https://cdn.media.amplience.net/i/ampproduct/ve-flows-webhook-trigger2-lm?w=1200&h=630
image_width: 1200
image_height: 630
date_published: 2025-11-24
date_modified: 2026-06-226
---

# Webhook trigger example- JIRA

Learn how to use a webhook trigger to start a [Workforce Flow](https://amplience.com/developers/docs/workforce/flows/about-flows/) automatically when a task is performed in an external app. In this case, when an issue is created or updated in JIRA.

- How to convert the webhook payload to JSON.

![Webhook trigger flow overview](https://cdn.media.amplience.net/i/ampproduct/ve-flows-webhook-trigger2-lm?w=1880&fmt=png&)

> **Info:** To build Flows you will need the Admin role on the hub. See [Workforce permissions](https://amplience.com/developers/docs/concepts/permissions/roles/#roles-and-workforce).

## Step 1: Setting up a content flow with a webhook trigger

- Create a new content flow and give it a label and description.

- From the **Action Library** open the **Automated triggers** and drag a **Webhook trigger** to your flow.

![Open the Triggers section from the action library](https://cdn.media.amplience.net/i/ampproduct/webhook-trigger-jira-example-v2-1?w=1880&fmt=png 'Open the Triggers section from the action library')

- Choose **Open webhook library** from the [action configuration panel](https://amplience.com/developers/docs/workforce/flows/action-reference/#inputs-outputs-and-ports). You can leave authorization turned off and keep the schema as the default.

![Creating the webhook URL](https://cdn.media.amplience.net/i/ampproduct/webhook-trigger-jira-example-2?w=1880&fmt=png 'Creating the webhook URL')

- The new webhook is displayed in your webhook library. Copy the webhook URL because you will need it when setting up the webhook trigger in JIRA.

![The new webhook is shown in the list. Copy the webhook URL because you will need it later](https://cdn.media.amplience.net/i/ampproduct/webhook-trigger-jira-example-3?w=1880&fmt=png 'The new webhook is shown in the list. Copy the webhook URL because you will need it later')

- In the action menu choose the webhook you just created as the webhook that will trigger this flow.

![Choosing the webhook to trigger the flow](https://cdn.media.amplience.net/i/ampproduct/webhook-trigger-jira-example-v2-4?w=1880&fmt=png 'Choosing the webhook to trigger the flow')

## Step 2: Add actions to your flow

Add the following actions to your flow:

- **Convert to JSON string**. This will convert the webhook payload to a JSON string. Connect this action to the webhook trigger.
- **Chat output**. Use this to output the JSON as a chat message. Connect this action to the **Convert to JSON string** action.

![Add actions to your flow to output the webhook payload](https://cdn.media.amplience.net/i/ampproduct/webhook-trigger-jira-example-v2-5?w=1880&fmt=png 'Add actions to your flow to output the webhook payload')

## Step 3: Creating a webhook in JIRA

You will need to have JIRA admin permissions to set up a webhook. In JIRA:

- Go to admin settings -> System -> Webhooks and choose "Create a Webhook".
- Enter the URL of the webhook you created in the [previous step](##step-1-setting-up-a-content-flow-with-a-webhook-trigger) as the webhook URL. The URL should start with `https//:api.amplience.net/hooks`.
- Choose the actions that you want to trigger the webhook, such as create or update issue.
- Create the webhook.

![Creating the webhook in JIRA](https://cdn.media.amplience.net/i/ampproduct/webhook-trigger-jira-example-6?w=1880&fmt=png 'Creating the webhook in JIRA')

> **Info:** You can run the flow in Test mode straight away, but it needs to be enabled before you or anyone else can run it for general use. Learn more about [Enabling Flows](https://amplience.com/developers/docs/workforce/flows/review/#enabling-flows-to-be-run).

## Try it out

- To test the flow, perform an action in JIRA that will trigger the webhook, such as creating or updating an issue.
- Navigate back to Workforce. If the webhook is triggered, a run of your content flow will start automatically and be shown in your runs list.

![The webhook is triggered and the flow is run. The new run is shown in the runs list](https://cdn.media.amplience.net/i/ampproduct/webhook-trigger-jira-example-7?w=1880&fmt=png 'The webhook is triggered and the flow is run. The new run is shown in the runs list')

- Click on the run in the runs list to view it. The run will be opened and you can see the payload of the JIRA webhook.

![Viewing the run. The payload of the JIRA webhook is displayed](https://cdn.media.amplience.net/i/ampproduct/webhook-trigger-jira-example-8?w=1880&fmt=png 'Viewing the run. The payload of the JIRA webhook is displayed')

> **Tip: Testing the flow**
> You can run the flow in test mode, you just need to enter a sample webhook payload.