Skip to main content
  • Setup
  • Reference

What You'll Need

CredentialDescription
API TokenGenerated from Atlassian account settings
Email AddressYour Atlassian account email
Jira Subdomaine.g., your-company.atlassian.net
Organization IDFound in Admin Console URL

​
Overview

API Token authentication uses Basic Auth with your Atlassian email and a generated token. This provides secure, automated access to Jira Cloud APIs.

​
Prerequisites

1

User Permissions

The user creating the API token needs these permissions:
For full data access, use an account with Jira Administrator privileges.
2

Org-Wide Settings

Ensure all user emails are set to Visible by “Anyone”:Users configure this in their Atlassian account settings under Profile and visibility → Contact.

​
Setup Guide

1

Access API Token Settings

Navigate to the Atlassian API Token Management page.Sign in with your Atlassian account credentials.
2

Create an API Token

  1. Click Create API token
  2. Enter a meaningful label: Parable Integration
  3. Click Create
Copy your now!This is the only time it will be displayed. Store it in a secure password manager before closing this page.
3

Find Your Organization ID

  1. Go to Atlassian Admin Console
  2. Look at the URL: https://admin.atlassian.com/o/{ORG_ID}/...
  3. Copy the ORG_ID value
4

Note Your Instance URL

Your Jira instance URL follows this pattern:
https://your-company.atlassian.net
Find this in your browser’s address bar when viewing Jira.