Jira is an issue-tracking product developed by Atlassian that allows bug tracking and agile project management.
When properly configured, the Greenhouse Onboarding / Jira integration will automatically create tasks assigned to Jira via email.
In this article:
Retrieve Jira email address
Greenhouse Onboarding uses a Jira email address to automatically add tickets to the ticketing system when a task is generated in Greenhouse Onboarding.
To enable Jira as a third-party task system, contact your organization's Jira administrator to secure the Jira email used for creating tickets. You'll use this later when enabling Jira on Greenhouse Onboarding.
Configure Jira email settings
Your organization will need to configure your Jira email account before Greenhouse Onboarding can email Jira with tasks.
From your Jira account, navigate to Configure > System > Mail > Incoming Mail.
Click Add incoming mail handler (or use Edit beside an existing mail handler).
From the Mail Handler dialog box, assign the following:
Click Next when ready.
From the subsequent dialog box, specify the following:
- Project to which Greenhouse Onboarding should add tasks to
- Type of issue that should be created
- Default Reporter
When finished, click Save.
Enable Jira on Greenhouse Onboarding
Once the Jira email address is copied and configured, navigate to Greenhouse Onboarding and click Settings from the navigation bar.
Select 3rd-Party Task Systems from the left-hand panel.
From the 3rd-Party Task Systems page, click Add New.
Give the 3rd-party task system a name and select Jira from the provided System dropdown menu.
Input the copied Jira email address in the Email Address field.
Since Greenhouse Onboarding allows tokens to be inserted into tasks (which can reveal personally identifiable information), you need to explicitly configure which fields Jira can view.
Use the Viewable Fields dropdown menu to select which fields Jira can view.
When finished, click Save and Close.
The Jira account will be added as a 3rd-party task system in Greenhouse Onboarding. Repeat the above steps for any additional Jira accounts that you need connected to Greenhouse Onboarding.
This Jira account (and any additional projects added to 3rd-Party Task Systems) can now be assigned tasks from Greenhouse Onboarding.
When tasks are assigned, they'll appear in Jira under the project you chose.
Your team can action the task/ticket like any other in their Jira project.
To learn more about using 3rd-party tasks system on Greenhouse Onboarding, click here.