Atlassian Service Account (API Token)

🚀 Quickstart

Connect to Atlassian using service account API tokens 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 (API Token).

Authorize Atlassian Service Account

Go to Connections -> Add Test Connection -> Authorize, then enter your Cloud ID, Service Account Email, and API Token. 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.

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

Implement Nango in your app

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