Jira
ToolJet allows you to connect to your Jira instance to perform various operations such as managing issues, users, worklogs, and boards.
Connection
To connect to a Jira data source in ToolJet, you can either click the +Add new data source button on the query panel or navigate to the Data Sources page in the ToolJet dashboard.
To connect to your Jira instance, the following details are required:
- URL: Your Jira instance URL
- Email: Your Jira account email
- Token: Your Jira API token
You can generate a personal access token from your Jira account Manage account > Security > API Tokens section.
Querying Jira
- Click the + button in the query manager at the bottom of the editor and select the Jira data source added earlier.
- Choose the resource and operation you want to perform on your Jira instance.
Query results can be transformed using transformations. Refer to our transformations documentation for more details: link
Supported Resources and Operations
ToolJet supports the following Jira resources and operations:
Issue
User
Worklog
Board
Issue
Get Issue
This operation retrieves details of a specific Jira issue.
Parameters:
- Issue key: The key or id of the issue to retrieve.
- Params/Body: Additional parameters such as fields to retrieve, expand options, etc.
Example:
Issue Key: 10001
Params/Body:
{
"fields": "summary,description,created",
"expand": "renderedFields,names"
}
Create Issue
This operation creates a new Jira issue.
Parameters:
- Params/Body: The details of the issue to be created.
Example:
Params/Body:
{
"fields": {
"project": {
"key": "SCRUM"
},
"summary": "A particular bug needs to be fixed.",
"description": "The XYZ feature is not working as expected.",
"issuetype": {
"name": "Bug"
},
"assignee": {
"accountId": "712020:4581444c-054e-41d8-90ed-6d1d849557f7"
},
"labels": [
"bug",
"urgent"
]
}
}
Delete Issue
This operation deletes a specific Jira issue.
Parameters:
- Issue key: The key or id of the issue to delete.
- Delete subtasks: Whether to delete the issue's subtasks.