Atlassian Service Account (OAuth 2.0)

🚀 Quickstart

Connect to Atlassian using OAuth 2.0 service account credentials with Nango and see data flow in 2 minutes.

Create an integration

In Nango (free signup), go to Integrations -> Configure New Integration -> Atlassian Service Account (OAuth 2.0).

Authorize Atlassian Service Account

Go to Connections -> Add Test Connection -> Authorize, then enter your Client ID, Client Secret, and Subdomain (optional). Later, you’ll let your users do the same directly from your app.

Call the Atlassian API

Let’s make your first request to the Atlassian API (retrieve your user information). 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/myself" \
  -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({
    // https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-myself/#api-rest-api-3-myself-get
    endpoint: '/ex/jira/{connectionConfig.cloudId}/rest/api/3/myself',
    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.