Jira

🚀 Quickstart

Connect to Jira with Nango and see data flow in 2 minutes.

Create the integration

In Nango (free signup), go to Integrations -> Configure New Integration -> Jira.

Authorize Jira

Go to Connections -> Add Test Connection -> Authorize, then log in to Jira. Later, you’ll let your users do the same directly from your app.

Call the Jira API

Let’s make your first request to the Jira API (fetch a list of issues). Replace the placeholders below with your secret key, integration ID, and connection ID:

cURL
Node

curl "https://api.nango.dev/proxy/ex/jira/{connectionConfig.cloudId}/rest/api/3/search?maxResults=10" \
  -H "Authorization: Bearer <NANGO-SECRET-KEY>" \
  -H "Provider-Config-Key: <INTEGRATION-ID>" \
  -H "Connection-Id: <CONNECTION-ID>"

Install Nango’s backend SDK with npm i @nangohq/node. Then run:

import { Nango } from '@nangohq/node';

const nango = new Nango({ secretKey: '<NANGO-SECRET-KEY>' });

const res = await nango.get({
    endpoint: '/ex/jira/{connectionConfig.cloudId}/rest/api/3/search',
    params: {
      maxResults: 10
    },
    providerConfigKey: '<INTEGRATION-ID>',
    connectionId: '<CONNECTION-ID>'
});

console.log(JSON.stringify(res.data, null, 2));

Or fetch credentials with the Node SDK or API.

The {connectionConfig.cloudId} in the URL represents the cloudId. You can get this value from your connection configuration after creating the connection. The cloudId is automatically set by Nango.

✅ You’re connected! Check the Logs tab in Nango to inspect requests.

Implement Nango in your app

Follow our Auth implementation guide to integrate Nango in your app.To obtain your own production credentials, follow the setup guide linked below.

📚 Jira Integration Guides

Nango maintained guides for common use cases.

How to register your own Jira OAuth app
Register an OAuth app with Jira and obtain credentials to connect it to Nango

Official docs: Jira REST API v3 Documentation

🧩 Pre-built syncs & actions for Jira

Enable them in your dashboard. Extend and customize to fit your needs.

Others

Function name	Description	Type	Source code
`add-attachment`	Attach a file to a Jira issue	Action	🔗 Github
`add-comment`	Add a comment to a Jira issue.	Action	🔗 Github
`add-watcher`	Add a watcher to a Jira issue	Action	🔗 Github
`add-worklog`	Log time against a Jira issue.	Action	🔗 Github
`create-issue-link`	Link two Jira issues with a relationship type	Action	🔗 Github
`create-issue`	Create a Jira issue in a project.	Action	🔗 Github
`delete-attachment`	Delete an attachment from a Jira issue	Action	🔗 Github
`delete-comment`	Delete a comment from a Jira issue	Action	🔗 Github
`delete-issue-link`	Delete a link between Jira issues	Action	🔗 Github
`delete-issue`	Delete a Jira issue by ID or key	Action	🔗 Github
`delete-worklog`	Delete a worklog from a Jira issue.	Action	🔗 Github
`get-create-issue-metadata`	Retrieve project and issue type metadata for issue creation.	Action	🔗 Github
`get-edit-issue-metadata`	Retrieve editable field metadata for an existing Jira issue	Action	🔗 Github
`get-field`	Retrieve Jira field metadata by field ID	Action	🔗 Github
`get-issue-changelog`	Retrieve the changelog for a Jira issue	Action	🔗 Github
`get-issue-type`	Retrieve Jira issue type metadata by issue type ID.	Action	🔗 Github
`get-issue`	Retrieve a Jira issue by ID or key	Action	🔗 Github
`get-myself`	Retrieve the currently authenticated Jira user.	Action	🔗 Github
`get-priority`	Retrieve a Jira priority by priority ID.	Action	🔗 Github
`get-project`	Retrieve a Jira project by ID or key.	Action	🔗 Github
`get-status`	Retrieve a Jira status by status ID or name.	Action	🔗 Github
`get-user`	Retrieve a Jira user by account ID	Action	🔗 Github
`list-fields`	List Jira field metadata available to the user.	Action	🔗 Github
`list-issue-comments`	List comments on a Jira issue with pagination	Action	🔗 Github
`list-issue-types`	List Jira issue types available to the user	Action	🔗 Github
`list-priorities`	List Jira priorities available to the user.	Action	🔗 Github
`list-project-components`	List components for a Jira project	Action	🔗 Github
`list-project-versions`	List versions for a Jira project	Action	🔗 Github
`list-projects`	List Jira projects accessible to the authenticated user.	Action	🔗 Github
`list-statuses`	List Jira statuses available to the user	Action	🔗 Github
`list-transitions`	List available workflow transitions for a Jira issue	Action	🔗 Github
`list-users`	Search Jira users visible to the authenticated account.	Action	🔗 Github
`list-watchers`	List watchers on a Jira issue	Action	🔗 Github
`list-worklogs`	List worklogs on a Jira issue	Action	🔗 Github
`remove-watcher`	Remove a watcher from a Jira issue	Action	🔗 Github
`search-issues`	Search Jira issues using JQL.	Action	🔗 Github
`transition-issue`	Move a Jira issue through a workflow transition.	Action	🔗 Github
`update-comment`	Update a comment on a Jira issue	Action	🔗 Github
`update-issue`	Update issue fields on an existing Jira issue	Action	🔗 Github
`update-worklog`	Update a worklog on a Jira issue.	Action	🔗 Github
`fields`	Sync Jira field metadata available to the authenticated user.	Sync	🔗 Github
`issue-types`	Sync Jira issue types available to the authenticated user	Sync	🔗 Github
`issues`	Sync Jira issues using JQL-backed search with incremental updates	Sync	🔗 Github
`project-components`	Sync Jira project components for projects in scope	Sync	🔗 Github
`project-versions`	Sync Jira project versions for projects in scope	Sync	🔗 Github
`projects`	Sync Jira projects accessible to the authenticated user.	Sync	🔗 Github
`users`	Sync Jira users visible to the authenticated account	Sync	🔗 Github

Overview

800+ APIs & Integrations

🚀 Quickstart

📚 Jira Integration Guides

🧩 Pre-built syncs & actions for Jira

Others

​🚀 Quickstart

​📚 Jira Integration Guides

​🧩 Pre-built syncs & actions for Jira

​Others

🚀 Quickstart

📚 Jira Integration Guides

🧩 Pre-built syncs & actions for Jira

Others