Jira - Nango Docs

🚀 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.

🧩 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
`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

​🚀 Quickstart

​📚 Jira Integration Guides

​🧩 Pre-built syncs & actions for Jira

​Others

🚀 Quickstart

📚 Jira Integration Guides

🧩 Pre-built syncs & actions for Jira

Others