Jira

Learn how to connect your Jira account to GroWrk to manage and place orders using tickets.

Connect your account

In the Integrations page in your Dashboard, search for Jira and select Get Started.
In Jira, create an API token. Go to Settings → Atlassian account settings and select the Security tab. Select Create API Token.
Back in the GroWrk Integrations Setup page, enter your Jira credentials and select Set Up.
In GroWrk, create an API key to create orders. Go to the Developers page and select Create API Key.
In Jira, create a webhook. Go to Settings → System and Webhooks tab.
Select Create a Webhook. Set the following fields:
- URL: https://io.growrk.com/api/webhooks/jira/ticket-event?apiKey={GW_API_KEY}
- Issue related events/JQL: labels = GroWrk AND labels not in (order-created, order-failed)
- Issue related events/issue: created, updated

Create a ticket in your Jira board.
- In the description, include the following fields:
  - Required: Type (Order type) and SN (Serial number). If there are multiple products, divide serial numbers with commas. Check for and delete any spaces that may have been entered after the the Type and SN.
  - Optional: Notes
- Select Create.
Create an order in GroWrk.
- To call the webhook endpoint, the ticket should be labeled GroWrk. Select the ticket and add the label.
The GroWrk and Jira ticket interaction results will be displayed. When successful, there will be a new comment stating that the order has been created. A new order-created label will be shown on the ticket.

If the ticket failed, the latest comment will state the reason for failure and an order-failed label.
Follow up on the failure based on the stated reason. For example, if the employee’s address is missing, update it in your Dashboard.
Go back to the Jira ticket and remove the order-failed label.
Your ticket will update automatically, and you'll receive a comment confirming the order was created successfully.